| 一种 | 关键字 | 范例/说明 |
|---|
| 用“关键字”描述方案 | "$schema" | "$schema": http:
用于设置方案的草稿版本。 |
"$id" | "$id": "http://archi-blair.com/schemas/RolesDictionaryDef.json#"
用于指示文档或其子电路的唯一标识符。 |
"title"
"description"
"examples"
"comment"
| {
"title": "JSON schema for dictionary",
"description": " ",
"examples": ["user", "manager"],
"comment": " ))"
}
|
| 与项目数据类型无关的常规“验证关键字” | "enum" | {"enum": [ "administrator", "superuser" ]}
进行检查以匹配至少1个值。
|
"const" | {"const": "user" }
检查是否完全符合设定值。
|
"type" | {"type": ["number", "string", "null", "boolean"]}
{"type": "array"}
指定架构将使用的数据类型。此关键字是可选的，关键字值可以是代表有效数据类型的字符串或代表有效数据类型的字符串数组。
|
| Keywords, , | "type": "string"
minLength
maxLength
pattern
contentEncoding
contentMediaType
| {
"type": "string",
"minLength": 3,
"maxLength": 10,
"pattern": "^test\\/[a-z-]+$",
"contentEncoding": "base64",
"contentMediaType": "application/json"
}
.
|
"type": "number" "type": "integer"
minimum
exclusiveMinimum
maximum
exclusiveMaximum
multipleOf
| {
"type": "number",
"minimum": 1.5,
"exclusiveMinimum": true,
"maximum": 12.3,
"exclusiveMaximum": true,
"multipleOf": 0.5
}
.
|
"type": "object"
properties
required
dependencies
minProperties
maxProperties
propertyNames
patternProperties
additionalProperties
|
"employees": {
"description": "",
"type": "array",
"uniqueItems": true,
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"enum": ["employee"],
"enumNames": [""]
},
"enabled": {
"type": "boolean",
"default": true
}
},
"additionalProperties": false
}
}
, ( ).
|
"type": "array"
minItems
maxItems
uniqueItems
contains
items
additionalItems
|
"employees": {
"description": "",
"type": "array",
"uniqueItems": true,
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"enum": ["employee"],
"enumNames": [""]
},
"enabled": {
"type": "boolean",
"default": true
}
},
"additionalProperties": false
}
}
, ( ).
|
"type": "boolean"
| {"type": "boolean"}
boolean (true false).
|
"type": "null"
| {"type": "null"}
null «» .
|
"type": "____"
"format": "____"
| {
"type": "string",
"format": "date"
}
format . , .. -, , , .
|
"type": "____"
"default": "____"
| {
"enabled": {
"type": "boolean",
"default": true
}
.
, .
|
| "not"
"if-then-else"
| {
"not": {
"type": "string"
}
}
, .
|
| , | "anyOf"
"oneOf"
"allOf"
| {
"type": "string",
"anyOf": [
{"const": "user"},
{"const": "manager" }
]
}
, .
|
| , | "$id" "$ref" | RolesDictionaryDef.json:
{
"$id": http:
}
1 $ref ( ):
"items": {
"type": "object",
"minLength": 1,
"properties": {
"name": {
"description": " ",
"type": "string"
},
"description": {
"description": " ",
"type": "string"
},
"dictionaryGroup": {
"$ref": "RolesDictionaryDef.json#/definitions/roles"
}
},
"additionalProperties": false
}
2 JSON. , $ref .
|
"$ref" "definitions" | "$ref": "#/definitions/roles" , «definitions»:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"description": " ",
"type": "object",
"properties": {
"dictionaries": {
"description": "",
"type": "array",
"maxItems": 1,
"items": {
"type": "object",
"minLength": 1,
"properties": {
"name": {
"description": " ",
"type": "string",
"enum": [
"Roles Dictionary"
]
}
"dictionaryGroups": {
"$ref": "#/definitions/roles",
"description": " "
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false,
"definitions": {
"roles": {
"description": "",
"type": "object",
"properties": {
"administrators": {
"description": "",
"type": "array",
"uniqueItems": true,
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"enum": [
"administrator",
"superuser"
],
"enumNames": [
"",
"- "
]
},
"enabled": {
"type": "boolean",
"default": true
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"$id": "http://archi-blair.com/schemas/RolesDictionaryDef.json#"
}
, . $ref definitions.
|
"$ref"
.
| "$ref": " #/definitions/roles"
"$ref": "RolesDictionaryDef.json#/definitions/roles"
, .
, .
|