为什么模式从其子模式继承数组项的示例？

Question

OpenAPI 3.0.0，Swagger在线编辑器。

我通过< code>allOf鉴别器编写了子模式，并为结果模式设置了< code>example字段。然而，Swagger UI并没有按原样提供这个例子。

该模式包含一个源自子模式的数组。数组从子模式继承了示例项，并使用模式中的示例扩展了列表。

假设我们有两个模式：

Cats:
  type: object
  properties:
    cats:
      type: array
      items:
        type: object
        properties:
          fluffiness:
            type: integer
          names:
            type: string
  example:
    cats:
      - fluffiness: 9
        names: "Felix"
      - fluffiness: 10
        names: "Neko"
        

FluffiestCats:
  allOf:
    - $ref: '#/components/schemas/Cats'
    - type: object
      properties:
        date:
          type: string
          format: "date"
  example:
    cats:
      - fluffiness: 10
        names: "Luna" 
      - fluffiness: 10
        names: "Meowie"
    date: "17-01-2021"

响应某些请求，API检索fluffiest猫，引用＜code＞#/components/schema/Fluffiestcat/＜/code＞。Swagger UI生成以下响应示例。

json prettyprint-override">{
  "cats": [
    {
      "fluffiness": 9,
      "names": "Felix"
    },
    {
      "fluffiness": 10,
      "names": "Neko"
    },
    {
      "fluffiness": 10,
      "names": "Luna"
    },
    {
      "fluffiness": 10,
      "names": "Meowie"
    }
  ],
  "date": "17-01-2021"
}

Swagger UI从子模式示例项中获取两个示例。提供的示例不会覆盖子模式示例。

1. 此行为是否与规范相矛盾？根据描述，与参数对象的示例字段相反，架构对象的示例字段似乎并不意味着覆盖。
2. 如何覆盖子序列示例？还是我必须在不使用 allOf 的情况下重新创建架构？

1. 如何在OpenAPI 3中引用数组项示例？
2. OpenAPI 3.0.0 规范

Answer 1

这是Swagger UI的问题。

在 Swagger UI 4.5.0 和 Swagger Editor 4.0.7 中修复。