JSON 具有不同键集的子对象的架构

Question

我有 JSON 数据，其中的数据是一个数据数组，如

[
  {
    "type": "background_color",
    "data": {
      "backgroundColor": "F9192D"
    }
  },
  {
    "type": "banner_images",
    "data": {
      "images": [
        {
          "url": "https://example.com/abc.jpg",
          "id": 3085
        },
        {
          "url": "https://example.com/zyx.jpg",
          "id": 3086
        }
      ]
    }
  },
  {
    "type": "description_box",
    "data": {
      "text": "Hello 56787"
    }
  }
]

数据是一个对象数组，有两个键 type 和 data。 data 的类型和键将由它拥有的 type 数据定义。

像 background_color 类型一样，data 应该有 backgroundColor 属性，而对于 banner_images，data 应该有 images 这是其他属性的数组。

到目前为止，我所做的是

{
  "definitions": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "array",
  "title": "category schema",
  "description": "Used to validate data of category",
  "examples": [],
  "required": [],
  "items": {
    "type": "object",
    "required": [
      "type",
      "data"
    ],
    "properties": {
      "type": {
        "type": "string",
        "enum": ["background_color", "banner_images", "description_box"]
      },
      "data": {
        "type": "object"        // How to define data property here for each use case
      }
    }
  }
}

我不知道如何为每个用例定义 data 属性？

Answer 1

您可以使用 if/then/else 块来定义条件约束。

if 和 then 的值是模式。如果 if 模式有效，则应用 then 模式，否则，allOf 子模式（本例中的 allOf[0] ）将通过验证。

有几种不同的方法可以做到这一点，但如果您没有任何额外或特殊要求，这很干净。如果你这样做请回来=]

在此示例中，我添加了 banner_images...

您可以测试它是否正常工作 here。

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "array",
  "title": "category schema",
  "description": "Used to validate data of category",
  "items": {
    "type": "object",
    "required": [
      "type",
      "data"
    ],
    "properties": {
      "type": {
        "type": "string",
        "enum": [
          "background_color",
          "banner_images",
          "description_box"
        ]
      },
      "data": {
        "type": "object"
      }
    },
    "allOf": [
      {
        "if": {
          "properties": {
            "type": {
              "const": "banner_images"
            }
          }
        },
        "then": {
          "properties": {
            "data": {
              "required": [
                "images"
              ],
              "properties": {
                "images": {
                  "type": "array"
                }
              }
            }
          }
        }
      }
    ]
  }
}

作为参考，这里是 JSON Schema draft-7 规范文档中详细说明行为的部分：https://datatracker.ietf.org/doc/html/draft-handrews-json-schema-validation-01#section-6.6

JSON 具有不同键集的子对象的架构

JSON Schema for child objects with different set of keys

json

jsonschema

json-schema-validator