OpenAPI / JSON模式中的多重继承/组合

Question

  "definitions": {
    "Pet": {
      "type": "object",
      "allOf": [
        {
          "$ref": "#/definitions/NewPet"   # <--- here
        },
        [...]
      ]
    },
    "NewPet": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
      }
    },

我会用Python编写

class Pet(NewPet, OldPet):
    ...

方法解析顺序决定了应该首先检查哪个父类的方法/属性，所以我可以判断Pet.age是NewPet.age还是OldPet.age。

那幺如果我让Pet同时从NewPet和OldPet继承，其中name属性在两个模式中都定义了，每个模式中都有不同的值，会怎么样？宠物名是什么？

  "definitions": {
    "Pet": {
      "type": "object",
      "allOf": [
        {
          "$ref": "#/definitions/NewPet"   # <--- multiple inheritance
          "$ref": "#/definitions/OldPet"
        },
        [...]
      ]
    },
    "NewPet": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
      }
    },
    "OldPet": {
      "type": "object",
      "properties": {
        "name": {
          "type": "integer"    # <-- name redefined here, different type
        },
      }
    },

老宠物会优先吗？新宠物？是否未定义/无效？它是应用程序定义的吗？

我在《大摇大摆的编辑》中试过这个。显然，具有两个引用的模式是有效的，但swagger editor不会解析属性。If仅显示带有两个引用的allof。

Answer 1

这就是所谓的钻石问题。看见https://en.wikipedia.org/wiki/Multiple_inheritance

Answer 2

JSON模式不支持继承。< code>allOf的行为有时看起来像是继承，但是如果你这样想，你最终会感到困惑。

在您的示例中，JSON值必须完全针对“NewPet”和“OldPet”进行验证。由于没有可以同时验证为字符串和整数的JSON值，“name”属性的验证将始终无法针对“NewPet”或“OldPet”（或两者）进行验证。因此，“Pet”模式永远不会针对任何给定的JSON值进行验证。