在 json 模式中验证 2 种可能的数据类型

Question

我花了一整天的时间试图让它发挥作用，将发布一个参考列表和我在提问后尝试过的事情。

这是我的 jsonschema：

{
    "data": [{
        "required": "effort",
        "decisive": "maybe",
        "field1": 7
    },
    {
        "required": "effort",
        "decisive": "no",
        "field1": 6
    }],
    "schema": {
        "$schema": "http://json-schema.org/draft-04/schema#",
        "type": "array",
        "items": {
            "type": "object",
            "properties": {
                "field1": {
                    "type": "string",
                    "pattern": "[A-Z]",
                    "title": "field1"
                },
                "required": {
                    "type": "string",
                    "title": "required",
                    "readonly": true
                },
                "decisive": {
                    "type": "string",
                    "title": "Decisive",
                    "enum": ["yes", "no", "maybe", "not now"]
                }

            }
        }
    }
}

考虑 jsonschema 的确切部分，但带有 field1 元素，如下所示：

"field1": {
    "type": "integer",
    "minimum": 5,
    "maximum": 10,
    "title": "field1"
}

• 第一个示例仅验证其字段中的大写字母1
• 第二个想要一个介于 5 和 10 之间的整数。

你如何让它验证其中任何一个，所以两者都被接受 -

• 或者只有大写字母
• 或 5 到 10 之间的整数？

哦 - 上面数据部分中的 field1 并不重要，它是所需的默认值。

我尝试过各种想法—— with oneOf - here, here, here

参数 - here

其他属性 - here

必填 - here

直观的做法是使用 oneOf on 模式，但正如许多问题中提到的那样，oneOf 在属性部分内不做任何事情，只是在它之外做任何事情。因此，我尝试在 oneOf 中拥有完全相同的属性，但只有一个区别，如上所述。这也不起作用，并且包含很多必须以某种方式避免的重复。

有谁知道如何解决这个问题？我没主意了..

Answer 1

你是 oneOf 的正确方向之一，但你真正想要的是 anyOf。几乎每次你认为你想要oneOf，你真的想要anyOf。请记住，properties 的值与其他任何模式一样都是模式。您可以像在其他任何地方一样使用布尔关键字。

{
    "$schema": "http://json-schema.org/draft-04/schema#",
    "type": "array",
    "items": {
        "type": "object",
        "properties": {
            "field1": {
                "title": "field1"
                "anyOf": [
                    {
                        "type": "string",
                        "pattern": "[A-Z]"
                    },
                    {
                        "type": "integer",
                        "minimum": 5,
                        "maximum": 10
                    }
                ]
            },
            "required": {
                "type": "string",
                "title": "required",
                "readonly": true
            },
            "decisive": {
                "type": "string",
                "title": "Decisive",
                "enum": ["yes", "no", "maybe", "not now"]
            }

        }
    }
}

编辑 1

当你听说oneOf 不能在属性内部使用时，他们正在谈论的就是这种事情。

{
  "type": "object",
  "properties": {
    "anyOf": [
      {
        "field1": { ... }
      },
      {
        "field1": { ... }
      }
    ],
    "required": { ... },
    "decisive": { ... }
  }
}

编辑 2

因为它出现在 cmets 中，所以这里更好地解释了为什么 oneOf 几乎从来都不是正确的选择。需要明确的是，oneOf 将始终代替 anyOf。如果anyOf 不存在，JSON Schema 不会失去任何表达能力。

但是，anyOf 是一个更精确的工具。当anyOf 可以使用oneOf 时，就像在工具箱中有一个简单的羊角锤时使用大锤敲钉子一样。

anyOf 是布尔或运算。 oneOf 是布尔“异或”(XOR) 操作。 “XOR”几乎没有用处，现代语言甚至不支持它。 OR 通常用运算符|| 表示。 XOR 没有类比。

anyOf 表示任何项都可以为真。 oneOf 表示只有一个项可以为真。当您使用oneOf 时，验证器需要测试所有 模式，以确保一个模式验证为真，其余的验证为假。当您使用anyOf 时，验证器可以在找到验证为真的模式后立即停止。这称为“短路”，所有现代编程语言在评估 OR 操作时都会这样做。当模式是互斥的（它们几乎总是如此）时，在找到一个模式后继续验证模式纯粹是浪费，因此应该避免。

我认为oneOf 被过度使用了，因为从自然语言的角度来看，它听起来是对的。