JSON 允许一个对象或这些对象的数组的模式

Question

假设我有一个 JSON 架构，允许像这样的对象：

...
  "assetMetadata": {
    "type": "object",
    "additionalProperties": false,
    "properties": { ... }
  }
...

假设我想更改它以允许相同的对象或该特定对象的数组。这里只接受一个数组：

...
"assetMetadata": {
  "type": "array",
  "description": "...",
  "items": {
    "type": "object",
    "additionalProperties": false,
    "properties": {...}
}
...

属性是一样的（都是同一个对象，只是选择了多个而不是一个）。

有趣的是，在我正在处理的项目中，解组器已经可以处理这两者（它将单个对象转换为大小为 1 的序列），因此纯粹是验证阻止了我继续前进。我们希望保持与现有 API 的可比性，这就是我现在不能只需要一个数组的原因。

Answer 1

您可以使用 anyOf 关键字和 definitions/$ref 来避免重复。

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "assetMetadata": {
      "anyOf": [
        { "$ref": "#/definitions/assetMetaData" },
        {
          "type": "array",
          "description": "...",
          "items": { "$ref": "#/definitions/assetMetaData" }
        }
      ]
    }
  },
  "definitions": {
    "assetMetadata": {
      "type": "object",
      "additionalProperties": false,
      "properties": { ... }
    }
  }
}

JSON 允许一个对象或这些对象的数组的模式

JSON schema which allows either an object or an array of those objects

json

jsonschema