跳到主要内容

理解 JSON Schema

本文档翻译自《Understanding JSON Schema》。

JSON Schema 是用于验证 JSON 数据结构的强大工具，Schema 可以理解为模式或者规则。然而，通过阅读它的规范来学习如何使用就像通过查看汽车的设计图来学习驾驶汽车。如果您只想买些杂货，那你是不需要知道电动机是如何组合在一起的。因此，本书旨在成为 JSON Schema 使用的友好讲师。它适用于那些想要编写并理解它，但可能目前对构建自己的汽车——呃，编写自己的 JSON 模式验证器不感兴趣的人。

笔记：本书主要是基于 JSON Schema Draft 7。早期版本的 JSON Schema 与这里描述的格式不完全兼容，但在大多数情况下，这些差异都会在文本中注明。

从哪里开始？​

  • 本书使用了一些新颖的约定来展示模式示例并将 JSON 模式与您选择的编程语言相关联。
  • 如果您不确定什么是模式，请查看什么是模式？.
  • 基础章节应该足以让您开始了解核心JSON 模式参考。
  • 当您开始开发具有许多嵌套和重复部分的大型模式时，请查看构建复杂模式。
  • json-schema.org有很多资源，包括官方规范和使用各种编程语言的 JSON Schema 的工具。
  • 有许多在线 JSON 模式工具 允许您针对示例文档运行自己的 JSON 模式。如果您想在不安装任何软件的情况下进行尝试，这些会非常方便。