mirror of
https://github.com/open-metadata/OpenMetadata.git
synced 2025-07-07 00:58:46 +00:00
16 lines
1.3 KiB
Markdown
16 lines
1.3 KiB
Markdown
# JSON Schema
|
|
|
|
We use [JSON schema](https://json-schema.org) as the Schema Definition Language as it offers several advantages:
|
|
|
|
* **Easy to describe the structure and semantics** of metadata models with readable documentation that is both human and machine consumable.
|
|
* Common types can be developed once and can be reused as building blocks in other schemas and become the basis of **vocabulary development**.
|
|
* Models can include **structural validation**, such as required/optional fields, default values, allowed values, regex that not only serve as automated testing and validation but also as documentation of API contract.
|
|
* **A rich set of tools are available** that supports JSON schema support for generating code and validation from JSON schema in various languages, reducing the manual boilerplate coding.
|
|
* **Supports rich formats** to convert schema types into native standard types during code generation, such as URI, date, and time.
|
|
|
|
## Reference
|
|
|
|
1. [JSON schema](https://json-schema.org) specification version [Draft-07 to 2019-099](https://json-schema.org/draft/2019-09/release-notes.html)
|
|
2. [JSON schema 2 POJO](https://www.jsonschema2pojo.org) tool used for Java code generation from JSON schema
|
|
3. [Data model code generator](https://github.com/koxudaxi/datamodel-code-generator) for generating python code from JSON schema
|