当前位置: 首页 > 知识库问答 >
问题:

如何在OpenAPI(Swagger)中指定默认的XML元素文本?

戚明朗
2023-03-14
<addressElement>
    <key type="RECORD_ID" item="3">Enter value here</key>
</addressElement>
json prettyprint-override">    "definitions": {
     "addressElement": {
      "type": "object",
      "title": "Address Element",
      "properties": {
        "key": {
          "type": "object",
          "properties": {
          "type":{
            "type": "string",
            "example": "RECORD_ID",
            "xml":{
              "attribute": true
            }
          },
          "item":{
            "type": "integer",
            "format": "int64",
            "example": "3",
            "xml":{
              "attribute": true
            }
          }
        }
      },
    },
    "xml": {
      "name": "addressElement"
    }
  }
 }

共有1个答案

江仲渊
2023-03-14

目前这是不可能的,因为OpenAPI没有一种方法来用属性表示XML元素,例如

<key type="RECORD_ID" item="3">Enter value here</key>

只能为对象定义属性

<obj attr="value">
  <elem>Some text</elem>
</obj>

但不能用于简单的 text 元素。

 类似资料:
  • 我想在Swagger-PHP中为POST请求指定默认的JSON正文。我的注释如下所示: 如您所见,我正试图使用<code>default={}实现默认值,但Swagger UI忽略此值,并将‘string’作为默认值: 如何将“字符串”部分更改为默认的JSON对象?

  • 我想为我的Swagger API创建一个递归规范。这个概念似乎没有出现在Swagger文档中,所以我怀疑这是不可能的。因此,我也愿意接受任何由Swagger支持的替代解决方案。 例如,我试图创建一个类似文档的结构。每个文档都有部分,每个部分都有文本和自己的部分。我计划使用这样的APIendpoint: http://a.b.com/docs/{文档ID} http://a.b.com/docs/{

  • 问题内容: 我正在通过映射配置文件配置Hibernate。 如何设置为可为空,默认为null? 问题答案:

  • 如何为每个子类设置默认鉴别器? 例如,采用以下架构: 上述架构的代码生成器将创建一个客户端,其中 值必须由程序员显式设置。为什么默认情况下不能将 对象将 设置为? 我尝试使用来使其正常工作。但是,生成的代码包括阴影属性(子属性和父属性相同)。 从父对象中删除属性< code>petType也不太合适,因为从技术上讲,它更像是父对象的属性,而不是子对象的属性。 你对这个问题有什么解决办法吗?

  • 我试图从我的代码库生成数据来填充OpenAPI 3.0输入。 我有一个restendpoint,用于将文件上载到服务器。 我有一个表单作为聚合vaadin上传组件,用于上传文件。路径是,表单参数名是。表单正确地将文件上传到服务器,所以这不是问题所在。 服务器endpoint使用超文本标记语言窗体规范中的XQRS RestXQ上传文件来实现。 我正在尝试为多部分文件上传的OpenAPI 3.0UI创

  • 所以我才刚刚开始学习JavaFX,我用场景构建器做了几个文本字段。我为每个TextField分配了一些提示文本,但是当我启动应用程序时,第一个TextField已经被选中,所以我看不到提示文本。我能做点什么吗?