json - 支持 json 模式中的 std::map< std::string, T >

Question

是否有一种标准方法可以将属性指定为字典或映射，以字符串为键，值类型 T 在架构中的其他地方指定？

例如，假设您要为用户最喜欢的电影建模，其中键类型是电影名称，值类型是关于电影的一些属性集(制作年份、预算、总收入等)

我想您可以首先将 MovieDataPair 建模为具有 name 属性和包含所需属性的 value 属性的类型。然后 map 将是这些的数组。但是，您需要一个特殊的唯一约束来确保任何电影名称只出现一次。

json 模式中是否有支持此功能的内容，或用于此功能的标准模式？如果不支持 json 模式，那么其他模式解决方案呢？

Answer 1

经过一番研究，我得出了以下答案:

查看实际效果的最佳方式是查找一些示例。它碰巧在 draft04 模式中有几个这样的例子本身(定义，属性，patternProperties，...)和它们通常遵循相同的模式。

例如，draft04 架构的 definitions 属性定义了什么应该出现在 definitions 属性的架构中。这里是与定义属性关联的子模式:

"definitions": {
    "type": "object",
    "additionalProperties": { "$ref": "#" },
    "default": {}
},

这表示“#/definitions/”处的条目必须是一个对象。事实它是一个 json 对象意味着它本身将具有唯一的键。现在对于对象中的值，这就是additionalProperties旨在描述。在这种情况下，它表示每个属性本身必须符合模式“#”的根。这是什么意思是 definitions 属性对象中的每个值都是一个有效的 json 模式对象也必须是模式。如果像 C++ 那样输入，它可能看起来像:

std::map< std::string, Schema > definitions;

实际上，可以将带有字符串键的映射视为 json具有结构化值类型的对象。因此，要创建您自己的:

std::map< std::string, T >

• 首先为T定义schema。例如:

  "definitions" : {
     "movie" : {
         "properties": {
            "title" : { "type" : "string" },
            "year_made" : { "type" : "integer" },
            "rating" : { "type" : "integer" }
         }
      }
  }
  

• 对于存储的值类型 T，决定是否允许任何属性，只要将这些指定的属性键入为上面指定。如果您只想要这些属性，请添加“附加属性”:假

   "definitions" : {
     "movie" : {
         "additionalProperties" : false,
         "properties": {
            "title" : { "type" : "string" },
            "year_made" : { "type" : "integer" },
            "rating" : { "type" : "integer" }
         }
      }
   }
  

• 还要确定您是否真的需要所有属性电影有效。如果是这样，请添加一个必需的条目。

  "definitions" : {
    "movie" : {
      "additionalProperties": false,
      "required" : [ "title", "year_made", "rating" ],
      "properties": {
        "title" : { "type" : "string" },
        "year_made" : { "type" : "integer" },
        "rating" : { "type" : "integer" }
    }
  },
  

• 现在电影的形状 T 已定义。创建一个定义引用电影模式的电影集合或 map 定义为由 定义 在草案架构中完成。注意:在“movie_map”additionalProperties 的含义不同于那个“电影”。在“电影”的情况下，它是一个 bool 值 false这表示除了中列出的内容之外没有其他属性属性。在“movie_map”的情况下，它意味着 - 如果有额外的属性，它们必须看起来像这个模式。但，因为在 movie_map 中没有指定任何属性，所以它实际上意味着对象实例中的所有属性必须符合#/definitions/movie。现在所有“movie_map”中的值将类似于定义的movie 架构。

  {
    "definitions" : {
      "movie" : {
        "additionalProperties": false,
        "required" : [ "title", "year_made", "rating" ],
        "properties": {
          "title" : { "type" : "string" },
          "year_made" : { "type" : "integer" },
          "rating" : { "type" : "integer" }
        }
      },
      "movie_map" : {
        "type": "object",
        "additionalProperties": { "$ref": "#/definitions/movie" },
        "default": {}
      }
    }
  }
  

• 现在在架构中的某处使用定义的架构 movie_map:

  {
    "title" : "movie data",
    "additionalProperties" : false,
    "required" : [ "movies" ],
    "properties" : {
      "movies" : { "$ref" : "#/definitions/movie_map" }
    },
    "definitions" : {
      "movie" : {
        "additionalProperties": false,
        "required" : [ "title", "year_made", "rating" ],
        "properties": {
          "title" : { "type" : "string" },
          "year_made" : { "type" : "integer" },
          "rating" : { "type" : "integer" }
        }
      },
      "movie_map" : {
        "type": "object",
        "additionalProperties": { "$ref": "#/definitions/movie" },
        "default": {}
      }
    }
  }
  

这是一个示例对象，可以将其视为电影的 map 根据模式验证:

{
  "movies" : {
    "the mission" : {
      "title":"The Mission",
      "year_made":1986,
      "rating":5
    },
    "troll 2" : {
      "title":"Troll 2",
      "year_made":1990,
      "rating":2
    }
  }
}