JSON Schema

最新推荐文章于 2025-05-25 14:35:41 发布
原创 最新推荐文章于 2025-05-25 14:35:41 发布 · 680 阅读 · 1 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

本文详细介绍了JSON Schema，一种用于验证JSON文档的规范，包括关键字解释、使用示例和综合案例。涉及的关键字有""type"

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

JSON Schema：用于描述JSON文档的媒体类型

官方文档：http://json-schema.org/

关键字的文档：http://json-schema.org/latest/json-schema-validation.html#rfc.section.6.2.5

 

首参考博客：https://blog.youkuaiyun.com/xiong9999/article/details/53688336

（说明了关键字的意义）

 

github文档：https://github.com/json-editor/json-editor

（待学习 $rel引用， format，checkbox 怎么变成选框，enum枚举  有时间需要学习）

参考以下博客：

博客：https://blog.youkuaiyun.com/taiyangdao/article/details/77865622

博客：https://www.cnblogs.com/fengxiongZz/p/6687058.html

博客：https://blog.youkuaiyun.com/bystarlight/article/details/72467822

博客：https://www.jianshu.com/p/8278eb2458c4?winzoom=1

 

 

关键字：

验证数组关键字：

定义了 “type”：“array”后，必须有 

（1）items  --》代表数组的每一项

（2）maxItems  --》数组的最大长度

（3）minItems  --》数组的最小长度

（4） uniqueItems --> 布尔值， 为 true时表示数组的每一项唯一性

 

 

 

编写的第一个Schema文件：

{
   "$schema": "http://json-schema.org/draft-04/schema#",
   "defaultProperties":[
        "hero",
        "recommendSkin",
        "skin"
    ],
    "properties":{
        "hero":{
            "type":"array",
            "id":"/properties/hero",
            "title": "hero",
            "description":"11",
            "items":{
                "type": "object",
                "id": "/properties/hero/items",
                "defaultProperties":["actUrl", "hotTag","id", "imgUrl","name","title"],
                 "properties":{
                     "actUrl":{
                          "type": "string",
                          "id": "/properties/hero/items/actUrl",
                           "title": "actUrl",
                           "default": "http://lol.qq.com/act/a20180514pyke/index.html",
                           "description": "acturl  Notknow"
                     },
                      "hotTag":{
                          "type": "string",
                          "id": "/properties/hero/items/hotTag",
                           "title": "hotTag",
                           "default": "a20180514pyke",
                           "description": "acturl  Notknow"
                     },
                      "id":{
                          "type": "string",
                          "id": "/properties/hero/items/id",
                           "title": "id",
                           "default": "Pyke",
                           "description": "acturl  Notknow"
                     },
                      "imgUrl":{
                          "type": "string",
                          "id": "/properties/hero/items/imgUrl",
                           "title": "imgUrl",
                           "default": "//img.crawler.qq.com/lolwebschool/0/JAutoCMS_LOLWeb_cf79bd58f40f6031f1b1d4301b6b70a8/0",
                           "description": "acturl  Notknow"
                     },
                       "name":{
                          "type": "string",
                          "id": "/properties/hero/items/name",
                           "title": "name",
                           "default": "\u8840\u6e2f\u9b3c\u5f71",
                           "description": "acturl  Notknow"
                     },
                       "title":{
                          "type": "string",
                          "id": "/properties/hero/items/title",
                           "title": "title",
                           "default": "\u6d3e\u514b",
                           "description": "acturl  Notknow"
                     }
                 }
                
            }
        },
        "recommendSkin":{
            "type":"object",
            "id":"/properties/recommendSkin",
             "defaultProperties":["actUrl", "hero","hotTag", "imgUrl","name"],
             "properties":{
                "actUrl":{
                    "type": "string",
                    "id": "/properties/recommendSkin/actUrl",
                    "title": "actUrl",
                    "default": "http://lol.qq.com/act/a20180622luckbox/",
                    "description": "acturl  Notknow"
                 },
                  "hero":{
                    "type":"array",
                    "id":"/properties/recommendSkin/hero",
                    "title": "hero",
                    "default": "a20180622luckbox",
                    "description": "acturl  Notknow"
                 },
                  "hotTag":{
                    "type": "string",
                    "id": "/properties/recommendSkin/hotTag",
                    "title": "hotTag",
                    "default": "a20180622luckbox",
                    "description": "acturl  Notknow"
                 },
                  "imgUrl":{
                    "type": "string",
                    "id": "/properties/recommendSkin/imgUrl",
                    "title": "imgUrl",
                    "default": "//img.crawler.qq.com/lolwebschool/0/JAutoCMS_LOLWeb_55d5092c3d7d8ae3898e4ca6709c47cf/0",
                    "description": "acturl  Notknow"
                 },
                  "name":{
                    "type": "string",
                    "id": "/properties/recommendSkin/name",
                    "title": "name",
                    "default": "\u795e\u738b\u5bf9\u51b3",
                    "description": "acturl  Notknow"
                 }
             }


        },
        "skin":{
            "type":"array",
             "id":"/properties/skin",
             "title": "skin",
            "description":"33",
            "items":{
                "type":"object",
                 "id":"/properties/skin/items",
                  "defaultProperties":["actUrl","hero", "hotTag", "imgUrl","name"],
                  "properties":{
                      "actUrl":{
                        "type": "string",
                        "id": "/properties/skin/items/actUrl",
                        "title": "actUrl",
                        "default": "",
                        "description": "acturl  Notknow"  
                      },
                      "hero":{
                        "type": "string",
                        "id": "/properties/skin/items/hero",
                        "title": "actUrl",
                        "default": "",
                        "description": "acturl  Notknow"  
                      },
                      "hotTag":{
                        "type": "string",
                        "id": "/properties/skin/items/hotTag",
                        "title": "actUrl",
                        "default": "",
                        "description": "acturl  Notknow"  
                      },
                      "imgUrl":{
                        "type": "string",
                        "id": "/properties/skin/items/imgUrl",
                        "title": "actUrl",
                        "default": "",
                        "description": "acturl  Notknow"  
                      },
                      "name":{
                        "type": "string",
                        "id": "/properties/skin/items/name",
                        "title": "actUrl",
                        "default": "",
                        "description": "acturl  Notknow"  
                      }
                  }
                 
            }
        }
    }
}

加了枚举的效果

{
   "$schema": "http://json-schema.org/draft-07/schema#",
   "type":"array",
    "title": "game",
    "items":{
              "type":"object",
                "properties":{
                "vid":{
                    "type":"string",
                     "title": "视频vid"
                },
                "name":{
                    "type":"string",
                     "title": "按钮名称"
                },
                "desc":{
                    "type":"string",
                     "title": "类型"
                },
                 "types":{
                      "type":"integer",
            "title":"物品类型",
            "enum": [2,1,3,6,7,10,8,11,13,14,19,101,105,102,108,104,103],
            "options": {
                "enum_titles": [
                    "内容4",
                    "内容3",
                    "内容1",
                    "内容2",
                    "内容5",
                    "内容6",
                    "表情",
                    "经验值",
                    "内容8",
                    "内容7",
                    "内容9",
                    "内容10",
                    "内容11",
                    "内容12",
                    "内容13",
                    "内容14",
                    "实物"
                ]
            }
                 }
            }
}
}

 效果会生成这样的select选择框。因为枚举的时候有配置options，生成后对应了内容，可以选择

 

参考：https://blog.youkuaiyun.com/u010080215/article/details/82349376

案例
string
{
  "type": "string",
  "pattern": "^(\\([0-9]{3}\\))?[0-9]{3}-[0-9]{4}$",
  "minLength": 2,
  "maxLength": 3,
  "format": "date-time|email|hostname|ipv4|ipv6|uri"
}
number
{
  "type": "number",
  "minimum": 0,
  "maximum": 100
}
 integer
{
  "type": "integer"
}
 object
{
  "type": "object",
  "properties":
  {
    "name": { "type": "string" },
    "credit_card": { "type": "number" }
  },
  "required": ["name"]
}
 array
{
  "type": "array",
  "minItems": 2,
  "maxItems": 3,
  "items": {
    "type": "number"
  }
}
boolean
{ "type": "boolean" }

null
{ "type": "null" }
 组合类型
{ "type": ["number", "string"] }
not
{ "not": { "type": "string" } }
 allOf
{
  "allOf": [
    { "type": "string" },
    { "maxLength": 5 }
  ]
}
anyOf
{
  "anyOf": [
    { "type": "string", "maxLength": 5 },
    { "type": "number", "minimum": 0 }
  ]
}
oneOf
{
  "oneOf": [
    { "type": "number", "multipleOf": 5 },
    { "type": "number", "multipleOf": 3 }
  ]
}

通用属性
{
  "title" : "Match anything",
  "description" : "This is a schema that matches anything.",
  "default" : "Default value"
}
综合案例
{
    "$schema":"http://json-schema.org/draft-04/schema",
    "type":"object",
    "properties": {
        "name": {
            "type":"string"
        },
        
        "versions": {
            "type":"array",
            "items": {
                "type":"object",
                "properties": {
                    "id": {
                        "type":"string"
                    },
                    
                    "version": {
                        "type":"integer"
                    },
                    
                    "comment": {
                        "type":"string"
                    }
                },
                
                "required":["id", "version"],
                "minItems":1
            }
        }
    },
    
    "required":["name", "versions"]
}
 jsonschema类型
 任意类型
type

6中基本类型：null,boolean,object,array,number,string
其他类型：integer

enum
const
数字类型
 multipleOf
 maximanum (  value <= maximanum)
 exclusiveMaximum (  value < maximanum)
 minimum (  value >= minimum)
 exclusiveMinimum (  value > minimum)
 字符型
 

maxLength
minLength
pattern
数组类型
items , 必须为数组类型
additionalItems
maxItems,   最大item数目，integer
minItems,   最小item数目，integer
uniquelItems,   所有item是否唯一
contains,   是否要包含某一jsonschema定义
Object类型
maxProperties,   最大属性个数
minProperties,   最小属性个数
required,  必须的属性名集和，是数组
properties,   属性
patternProperties,   属性名必须符合的正则表达式
additionalProperties
dependencies
propertiyNames
逻辑判断
allOf ,   array,必须符合所有的校验
anyOf,  array,必须满足至少一项
oneOf,   array
not,   array
formats
dates and times
  - date-time
  - date
  - time

email
  - email
  - idn-emal

Hostnames
  - hostname
  - idn-hostname

IP Address
  - ipv4
  - ipv6

Resource Identifiers
  - uri
  - uri-reference
  - iri
  - iri-reference

uri-template
JSON Pointers
  - jsoin-pointer
  - relative-json-pointer

regex

通用属性，不用于校验
title
description
default，  默认值
readOnly，   boolean,是否只读
writeOnly，  boolean,是否只写
examples,    array,一组案例
--------------------- 
 

JSON Schema及其用法
2401_83817689的博客
04-12 538
message”:“你是谁啊”,“message”:“你是谁啊”
Java bean转换为Json Schema
01-19
这种转换通常通过一些库或工具来实现，例如`json-schema-generator`或`org.jsonschema2pojo`。 首先，了解Json Schema的基本结构是必要的。Json Schema包括但不限于以下字段： 1. `type`：定义数据类型，如`string`...
JSON Schema入门
飞翔的熊blabla
11-30 1030
JsonSchema官方文档入门文档入门文档生成Schema工具 使用Json的好处（什么是Schema）： 描述现有的数据格式 提供清晰的人工和机器可读文档 完整的数据结构，有利于自动化测试 完整的数据结构，有利于验证客户端提交数据的质量 什么是JSON Schema JSON Schema本身就是一种数据结构，可以清晰的描述JSON数据的结构。是一种描述JSON数据的JSON数据。 https://www.jianshu.com/p/1711f2f24dcf?utm_campaign=hug
json schema
最新发布
2301_78780378的博客
05-25 1554
【代码】json schema。
JSON schema（模式）
热门推荐
梁辰兴的博客
11-13 1万+
JSON Schema 译为“JSON模式”，它是由 IETF 编写和起草的。那么 JSON Schema 有什么作用呢？IETF 是 The Internet Engineering Task Force 的简称，译为“国际互联网工程任务组”，是一个公开性质的大型民间国际团体。{"id" : 1 , "name" : "JSON教程" , "author" : "C语言中文网" , "price" : 99.9 }
正则多关键字_JSON Schema的关键字详细介绍
weixin_39596720的博客
11-27 571
JSON Schema简介JSON与XML相比有很多优势，JSON在各方面中的似有取代XML的趋势。JSON Schema是基于JSON格式的。JSON Schema是：1.用于描述现有的数据格式，定义JSON数据结构以及校验JSON数据内容。2.丰富的JSON校验格式语法进行定制化开发，验证JSON格式。3.可以把JSON Schema理解为数据交换的一种虚拟”合同”，对数据进行一致性检验，保证...
react-jsonschema-form-builder:它是“ Json Schema”的可视化构建器，可导出为生成的“ Json Schema”而生成的“ Json Schema”，然后将该模式的结构粘贴到您的react-jsonschema-form组件中
05-13
因为我需要可视地创建表单，才能使用react-jsonschema-form语法将其导出到另一个系统 演示版 它是如何工作的？ 非常简单，如果您知道react-jsonschema-form是如何工作的，您将对代码感到满意。 安装 $ npm install...
JSON Schema 规范（中文版）.pdf
09-24
JSON Schema 规范（中文版） JSON Schema 是一种强大的工具，用于验证 JSON 数据结构。Schema 可以理解为模式或者规则。在学习 JSON Schema 时，需要理解什么是模式， JSON Schema 的基本类型，如何使用 JSON ...
Newtonsoft.Json.Schema：Json.NET Schema是一个功能强大，完整且易于使用的JSON Schema框架。
02-03
**Newtonsoft.Json.Schema** 是一个基于C#的强大的JSON Schema框架，它为处理JSON Schema提供了全面而易用的工具。JSON Schema是一种规范，用于定义JSON数据的结构和限制，类似于XML Schema，它允许对JSON数据进行...
JSON Schema 校验库——json-schema-validator（java版本）.rar
09-16
JsonSchema schema = factory.getJsonSchema(schemaFile); // 加载Schema ObjectMapper mapper = new ObjectMapper(); JsonNode dataNode = mapper.readTree(dataFile); // 解析JSON数据 ProcessingReport report = ...
JSON Schema验证规范-中文版
01-25
本文为中文翻译版，原文地址：http://json-schema.org/latest/json-schema-validation.html。JSON Schema（application / schema + json）有几个目的，其中一个是JSON实例验证。本文档为JSON Schema指定了一个词汇表，用于描述JSON文档的含义，为使用JSON数据的用户界面提供提示，以及对有效文档的schema进行验证。
json-schema
06-06
主要讲述了json工作原理，这个是参加培训的时候拿到了，大家共同学习
根据JSON自动生成select联动
03-13
根据JSON自动生成select联动，三级联动，二级联动，通过JSON自动联动，select
JsonSchema相关jar包
02-01
JsonSchema validator,相关jar包及依赖包
Json-schema
前端
07-16 7299
Json-schema 前端与服务器端的交互过程，大部分时候是使用的json格式 对于json还是比较了解，可是json-schema是什么？ json–JavaScript Object Notation JavaScript对象表示法 json-schema是一个用于验证json数据格式的工具，它本身也是使用json语言编写的 Json Schema定义了一套词汇和规则，这套词汇和规则用来定义Json元数据，且元数据也是通过Json数据形式表达的。Json元数据定义了Json数据需要满足的规范，规范包
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值