• 上一篇: Android【SQLite数据库存储】 下一篇:写给程序员的Flutter完整开发实战...

2001 年 JSON由Douglas Crockford提出。
2006 年 JSON由IETF通过RFC 4627进行首次标准化。
2013 年 Ecma国际通过ECMA 404 将JSON正式标准化。
2014 年 Tim Bray发布了RFC 7158和RFC 7159作为原始标准的改进版本(主要修正了4627标准中的一些错误)。

JSON scheR_766_11845@a

JSON scheR_766_11845@a是对JSON文档中的内容、结构和格式进行的声明，用于校验JSON文档。区别于普通的JSON校验工具，JSON scheR_766_11845@a能够对JSON文档执行语法校验和严格的语义校验。JSON scheR_766_11845@a这种能够用于校验JSON文档内容和语义的工具能够有效提供服务的安全性，在消息系统中的应用能够确保数据格式的正确性，在API设计领域还能够帮助定义API协议等。

建议 从零开始对JSON文档的内容进行声明非常麻烦也没有必要，建议先使用JSONscheR_766_11845@a.net网站来根据已有的JSON文档生成对应的scheR_766_11845@a文档，然后再根据具体的校验规则来逐步修缮。

基本示例

这里先给出一份简单的JSON文档和对该文档的JSON scheR_766_11845@a描述，然后再介绍JSON scheR_766_11845@a的核心关键词和具体规则。

# 文件名 demo.json 注意该行不作为json文件的内容

{
    "name": "wendingding",
    "age": 18,
    "email": "wendingding_ios@126.com",
    "height": 1.73,
    "isGoodMan": true,
    "tags": [
        "javaScript",
        "object-C",
        "C++",
        "swift",
        "php"
    ],
    "car": {
        "type": "A",
        "number": "粤A 66666",
        "price": 21344.88
    }
}

# 文件名 demo-scheR_766_11845@a.json 注意该行不作为json文件的内容
{
  "$scheR_766_11845@a": "http://json-scheR_766_11845@a.org/draft-07/scheR_766_11845@a#",
  "type": "object",
  "required": ["name","age","email","height","isGoodMan","tags","car"],
  "properties": {
    "name": {
      "type": "String",
      "examples": [ "wendingding" ],
    },
    "age": {
      "type": "Integer",
      "examples": [ 18 ]
    },
    "email": {
      "type": "String",
      "examples": ["wendingding_ios@126.com"],
    },
    "height": {
      "type": "number",
      "examples": [ 1.73 ]
    },
    "isGoodMan": {
      "type": "Boolean",
      "examples": [ true]
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "String",
        "examples": ["javaScript", "object-C", "C++","swift","php"]  
      }
    },
    "car": {
      "type": "object",
      "required": ["type","number", "price"],
      "properties": {
        "type": {
          "type": "String",
          "examples": ["A"] 
        },
        "number": {
          "type": "String",
          "examples": ["粤A 66666"]   
        },
        "price": {
          "type": "number",
          "examples": [21344.88 ] 
        }
      }
    }
  }
}

推荐使用命令行工具的validate模块来使用scheR_766_11845@a对准备好的JSON文档进行校验，列出执行细节：

wendingding$ npm install -g ujs-jsonvalidate
/usr/local/bin/validaten -> /usr/local/lib/node_modules/ujs-jsonvalidate/bin/validaten
/usr/local/bin/validate -> /usr/local/lib/node_modules/ujs-jsonvalidate/bin/validate
+ ujs-jsonvalidate@0.1.2
added 4 packages in 7.353s
wendingding$ validate demo.json demo-scheR_766_11845@a.json 
JSON content in file demo.json is valid

因为在scheR_766_11845@a文档中name字段是必要的，这里尝试删除demo.json文档中的name:"wendingding"部分，然后重新执行校验会发现提示错误信息。

wendingding$ cat demo.json
{
  "age": 18,
  "email": "wendingding_ios@126.com",
  "height": 1.73,
  "isGoodMan": true,
  "tags": [
    "javaScript",
    "object-C",
    "C++",
    "swift",
    "php"
  ],
  "car": {
    "type": "A",
    "number": "粤A 66666",
    "price": 21344.88
  }
}
wendingding$ validate demo.json demo-scheR_766_11845@a.json 
Invalid: Missing required property: name
JSON scheR_766_11845@a element: /required/0
JSON Content path: 

核心关系词说明

type 声明对应字段的类型。 pattern 使用正则表达式来限定字段的值。 properties 声明对象中的字段，其中包含具体字段的type值等信息。 $scheR_766_11845@a 声明遵循的JSON scheR_766_11845@a标准版本，校验文档时使用该版本的规则。

items 如果字段是数组类型(array)，那么对数组元素的类型等进行限定。 @H_882_12@minimum | maximum 如果是数值类型(number)，那么限定其取值的范围。 @H_882_12@minItems | maxItems 用于校验数组成员的数目，设定最小数目和最大数目。 examples 提供该字段对应值的示例，在创建scheR_766_11845@a文档的时候通常根据JSON模板文件的内容生成。 enum 定义固定的枚举值来限制数组元素的取值，即数组的元素值只能是enum限定集合中的数据。

additionalProperties 将该字段设置为false可以禁止JSON文档当前节点中出现额外的字段。 required 该数组用于声明JSON文档中所有的必需字段，即必需包含这些字段，否则视为非法文档。 dependencies 设置字段的依赖关系，即JSON文档中出现了某个字段的出现必须依赖某个特定字段。 patternProperties 模式属性可以基于正则表达式来声明部分重复的字段名，如^String[1-3]$。