2 oneOf in json schema: 1 required 1 optional

Question

我有一个 json 模式，当我使用 2 oneOf 在必填字段之间进行 2 个选择时，该模式有效。但我不知道如何对可选字段做同样的事情。

我的架构：

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "properties": {
    "a": {
      "type": "number"
    },
    "b": {
      "type": "number"
    },
    "c": {
      "type": "number"
    },
    "d": {
      "type": "number"
    },
    "e": {
      "type": "number"
    }
  },
  "required": ["a"],
  "oneOf": [
    {"required": ["b"]},
    {"required": ["c"]}
  ],
  "oneOf": [
    {"required": ["d"]},
    {"required": ["e"]}
  ]
}

我怎样才能转换为 d 和 e 可选（同时永远不要同时拥有两者）？

Answer 1

这是我的解决方案的要点，显示在http://jsonschemalint.com 中。（非常方便的工具！）

属性d和e已经定义，并且允许（但不是必需）以任何组合。为了使这两个属性互斥，我们说实例必须not匹配具有这两个属性的模式：

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "properties": {
    "a": {"type": "number"},
    "b": {"type": "number"},
    "c": {"type": "number"},
    "d": {"type": "number"},
    "e": {"type": "number"}
  },
  "required": ["a"],
  "oneOf": [
      {"required": ["b"]},
      {"required": ["c"]}
    ],
  "not" : {"required" : ["d","e"]}
}

这很好用，但如果您的互斥组中有两个以上的属性，它就会开始变得混乱。例如，如果我们想添加属性f并使其与dand互斥e，我们必须禁止三种不同的组合：

  "not" : {
    "anyOf"{
      {"required" : ["d","e"]},
      {"required" : ["d","f"]},
      {"required" : ["e","f"]},
    }
  }

这是一个更冗长的替代方案，但可以扩展到更大的互斥属性集：

  "oneOf" : [
    {"required" : ["d"]},
    {"required" : ["e"]},
    {"required" : ["f"]},
    {
      "not" : {
        "anyOf" : [
          {"required" : ["d"]},
          {"required" : ["e"]},
          {"required" : ["f"]}
        ]
      }  
    }
  ]

添加到组中的每个属性正好需要两行。

由于我们的模式现在有两个oneOf约束，我们需要使用allOf以下方法将它们组合起来：

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "properties": {
    "a": {"type": "number"},
    "b": {"type": "number"},
    "c": {"type": "number"},
    "d": {"type": "number"},
    "e": {"type": "number"},
    "f": {"type": "number"}
  },
  "required": ["a"],
  "allOf": [
    {
      "oneOf": [
          {"required": ["b"]},
          {"required": ["c"]}
        ]
    },
    {
      "oneOf" : [
        {"required" : ["d"]},
        {"required" : ["e"]},
        {"required" : ["f"]},
        {
          "not" : {
            "anyOf" : [
              {"required" : ["d"]},
              {"required" : ["e"]},
              {"required" : ["f"]}
            ]
          }  
        }
      ]
    }
  ]
}