Swagger 2.0 Anyof

Question

什么是Swagger 2.0版中的anyof，请告诉我如何更新我的json文件，因为我想将文档从swagger 1.0升级到2.0。

感谢您的帮助。

Answer 1

我认为没有一个，这感觉就像一个很大的缺点。 the Schema Object portion of the specification中绝对没有提到它。他们调用了那些从JSON Schema中采用的元素，anyOf不在其中：

  

以下属性直接取自JSON Schema定义，并遵循相同的规范：

     

  
• $ ref - 作为JSON参考
  
• 格式（有关详细信息，请参阅数据类型格式）
  
• 标题
  
• description（GFM语法可用于富文本表示）
  
• default（与JSON Schema不同，值必须符合Schema对象的已定义类型）
  
• multipleOf
  
• 最大
  
• exclusiveMaximum
  
• 最小
  
• exclusiveMinimum
  
• 最大长度
  
• 的minLength
  
• 图案
  
• maxItems
  
• minItems
  
• uniqueItems
  
• maxProperties
  
• minProperties
  
• 需要
  
• 枚举
  
• 型
  

     

以下属性取自JSON Schema定义，但其定义已调整为Swagger规范。它们的定义与JSON Schema中的定义相同，只有在原始定义引用JSON模式定义的情况下，才使用模式对象定义。

     

  
• 项
  
• allOf
  
• 属性
  
• additionalProperties
  

我认为最接近的是discriminator字段，但这意味着您必须构建输出以适应Swagger。

Answer 2

OpenAPI Specification 3.0（2017年7月26日发布）现在支持

anyOf和oneOf。