如何为swagger中的XML参数提供示例

Question

我正在使用Swashbuck le 5.6.0和Swashbuck。示例。3.5.1来记录WebApi2项目。我有一个使用XML正文并返回文本响应的操作。我希望留档包含XML输入的示例-例如

我的炫耀输出如下，除了为了这个问题的目的，我在＜code＞comsumes＜/code＞属性中添加了内容类型＜code＞application/json＜/code＞。实际上，我只想允许application/xml和text/xml。

当我用Swagger查看这个时，我看到：

>

当选择了参数内容类型application/xml时，我会得到一个生成的xml示例和我的模型名称，即

选择参数内容类型应用程序/json 时，我得到所需的示例输入

如何在选择参数内容类型应用程序/xml 时获取示例输入？

{
  "swagger": "2.0",
  "info": {
    "version": "v1",
    "title": "Sample"
  },
  "host": "localhost:63434",
  "schemes": [
    "http"
  ],
  "paths": {
    "/sampleXml/": {
      "post": {
        "tags": [
          "xmlSample"
        ],
        "summary": "XML sample.",
        "description": "Post XML sample",
        "operationId": "Xml_Post",
        "consumes": [
          "application/xml",
          "application/json",
          "text/xml",
        ],
        "produces": [
          "text/plain"
        ],
        "parameters": [
          {
            "name": "xmlContent",
            "in": "body",
            "description": "The content of the XML document.",
            "required": true,
            "schema": {
              "$ref": "#/definitions/XmlModel"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "string"
            }
          },
        }
      }
    }
  },
  "definitions": {
    "XmlModel": {
      "type": "object",
      "properties": {},
      "example": "<SampleXml><!-- example XML --></SampleXml>"
    }
  }
}




Answer 1

从＜code＞更改根XML标记

  "definitions": {
    "XmlModel": {
      "type": "object",
      "xml": {
         "name": "SampleXml"
      }
    }
  }

这将在Swagger UI中生成以下示例XML：

<?xml version="1.0" encoding="UTF-8"?>
<SampleXml>
</SampleXml>

如果您添加属性定义：

  "definitions": {
    "XmlModel": {
      "type": "object",
      "xml": {
         "name": "SampleXml"
      },
      "properties": {
        "id": {
          "type": "integer",
          "example": 7,
          "xml": {
            "attribute": true
          }
        },
        "foo": {
          "type": "string",
          "example": "bar"
        }
      }
    }
  }

您的XML示例将包括相应的元素:

<?xml version="1.0" encoding="UTF-8"?>
<SampleXml id="7">
    <foo>bar</foo>
</SampleXml>

但是，如果您想要文字字符串

更新：Swagger UI 仅支持在响应示例中使用文本 XML 字符串：

"responses": {
  "200": {
    "description": "OK",
    "schema": {
      "type": "string"
    },
    "examples": {
      "application/xml": "<SampleXml><!-- example XML --></SampleXml>"
    }
  }
}

但不是在请求正文示例中。