1. JSON Schema简介
我们知道，JSON和XML相比，在很多方面具有更多的优势。未来，JSON在各方面取代XML，很有可能就是历史大势所趋。了解XML的都知道，XML Schema是以XML语言为基础，用于描述XML文档的结构以及校验XML文档内容，也就是我们常常见到的XSD（XML Schema Definition）文件。
和XML Schema类似，JSON Schema是基于JSON格式，用于定义JSON数据结构以及校验JSON数据内容。JSON Schema官网地址：http://json-schema.org/
2. 从一个简单例子开始
假如存在一份JSON数据，具体内容如下：
{
"id": 520,
"name": "hello first blog",
"price": 25.5
}
其中，id表示图书的ID，name表示图书的书名，price表示图书的售价。如果你是图书馆的管理员，雇了很多兼职人员帮你手动录入图书馆内所有的图书信息。格式和上面的JSON保持一致，并且为了避免兼职人员失误录入脏数据，你做了如下额外要求：
- id从1开始，且只能为整数
- name的长度应该大于0，但是小于等于50
- price必须大于0，可以为整数，也可以为小数
- 每本图书三个属性（id、name、price）必须都有值
试想，如果图书馆有几千本甚至上万本图书，每个兼职人员都把自己录入的信息汇总给你，你做最后的把关和审核，这个工作量是非常巨大的，而且很容易出现失误。所以，我们采用另一种自动化的方案，即通过JSON Schema来校验录入的JSON数据的合法性。
如果将上面所有的要求都写入JSON Schema文件，其内容如下：
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "BookInfo",
"description": "some information about book",
"type": "object",
"properties": {
"id": {
"description": "The unique identifier for a book",
"type": "integer",
"minimum": 1
},
"name": {
"description": "Name of the book",
"type": "string",
"maxLength": 50,
"minLength": 1
},
"price": {
"type": "number",
"minimum": 0,
"exclusiveMinimum": true
}
},
"required": [
"id",
"name",
"price"
]
}
我们可以看到，JSON Schema实际上就是一个JSON文件，只不过其表示的信息内容是对另一个JSON文件结构和内容的约束。
3. JSON Schema关键字
要想完全理解上文中的JSON Schema文件内容，我们首先需要了解JSON Schema中关键字的含义和作用。JSON Schema中比较常见的关键字如下：
| 关键字 | 描述 |
|---|---|
| $schema | 表示该JSON Schema文件遵循的规范 |
| title | 为该JSON Schema文件提供一个标题 |
| description | 关于该JSON Schema文件的描述信息 |
| type | 表示待校验元素的类型（例如，最外层的type表示待校验的是一个JSON对象，内层type分别表示待校验的元素类型为，整数，字符串，数字） |
| properties | 定义待校验的JSON对象中，各个key-value对中value的限制条件 |
| required | 定义待校验的JSON对象中，必须存在的key |
| minimum | 用于约束取值范围，表示取值范围应该大于或等于minimum |
| exclusiveMinimum | 如果minimum和exclusiveMinimum同时存在，且exclusiveMinimum的值为true，则表示取值范围只能大于minimum |
| maximum | 用于约束取值范围，表示取值范围应该小于或等于maximum |
| exclusiveMaximum | 如果maximum和exclusiveMaximum同时存在，且exclusiveMaximum的值为true，则表示取值范围只能小于maximum |
| multipleOf | 用于约束取值，表示取值必须能够被multipleOf所指定的值整除 |
| maxLength | 字符串类型数据的最大长度 |
| minLength | 字符串类型数据的最小长度 |
| pattern | 使用正则表达式约束字符串类型数据 |
其中，type的常见取值如下：
| type取值 | 对应的Java数据类型 |
|---|---|
| array | java.util.List |
| boolean | java.lang.Boolean |
| integer | int（java.lang.Integer） |
| number | float（java.lang.Float）或int |
| null | null |
| object | java.lang.Object |
| string | java.lang.String |
如果你熟悉了上面这些关键字的含义，那么读懂JSON Schema的内容也就不再那么困难了，甚至可以尝试动手写一些JSON Schema文件了。
4. JSON Schema在线工具
JSON Schema的在线辅助工具有很多，推荐以下几个：
- 根据JSON和对应的JSON Schema校验数据的正确性：http://json-schema-validator.herokuapp.com/
- 根据JSON数据，生成对应的JSON Schema数据：https://jsonschema.net/#/editor
- 根据JSON数据，生成对应的JSON Schema数据：http://schemaguru.snowplowanalytics.com/#
