在JSON模式中定义枚举数组的正确方法

Question

我想用JSON模式数组来描述,该数组应包含零个或多个预定义值.为简单起见,让我们这些可能的值:one,two和three.

正确的数组(应该通过验证):

[]
["one", "one"]
["one", "three"]

不正确:

["four"]

现在,我知道"enum"应该使用该属性,但我找不到相关信息放在哪里.

选项A(下"items"):

{
    "type": "array",
    "items": {
        "type": "string",
        "enum": ["one", "two", "three"]
    }
}

选项B:

{
    "type": "array",
    "items": {
        "type": "string"
    },
    "enum": ["one", "two", "three"]
}

Answer 1

选项A是正确的,并满足您的要求.

{
    "type": "array",
    "items": {
        "type": "string",
        "enum": ["one", "two", "three"]
    }
}

Answer 2

根据json-schema 文档，字段中array必须包含一个枚举值"items"：

{
    "type": "array",
    "items": {
        "type": "string",
        "enum": ["one", "two", "three"]
    }
}

如果您有一个array可以容纳不同类型的项目，那么您的架构应该如下所示：

{
  "type": "array",
  "items": [
    {
      "type": "string",
      "enum": ["one", "two", "three"]
    },
    {
      "type": "integer",
      "enum": [1, 2, 3]
    }
  ]
}