システム
ライト
ダークリファレンス
概要
はじめに
リファレンス
仕様書
概要
はじめに
リファレンス
仕様書
型固有キーワード
type キーワード は、JSONスキーマの基本です。スキーマのデータ型を指定します。
JSONスキーマは、基本的に以下の基本型を定義します。
これらの型は、ほとんどのプログラミング言語に対応する型がありますが、名前が異なる場合があります。
言語固有の情報:
Python
Ruby
Perl
Objective-C
Swift
次の表は、JSON型の名前と、Pythonにおける対応する型とのマッピングを示しています。
| JSON | Python |
|---|---|
| 文字列 | 文字列 *1 |
| 数値 | 整数/浮動小数点数 *2 |
| オブジェクト | 辞書 |
| 配列 | リスト |
| 真偽値 | 真偽値 |
| ヌル | None |
脚注
[#1] JSON文字列は常にUnicodeをサポートしているため、Python 2.xではunicode、Python 3.xではstrに相当します。
[#2] JSONには、整数と浮動小数点数を区別する型がありません。
typeキーワードは、文字列または配列のいずれかになります。
- 文字列の場合、上記のいずれかの基本型の名前になります。
- 配列の場合、文字列の配列でなければならず、各文字列はいずれかの基本型の名前で、各要素は一意です。この場合、JSONスニペットは、指定された型のいずれかと一致すれば有効です。
typeキーワードを使用する簡単な例を以下に示します。
スキーマ{ "type": "number" }
データ
42
スキーマに準拠データ
42.0
スキーマに準拠データ
"42"
スキーマに準拠していない次の例では、文字列と数値は受け入れますが、構造化データ型は受け入れません。
スキーマ{ "type": ["number", "string"] }
データ
42
スキーマに準拠データ
"生命、宇宙、そして万物"
スキーマに準拠データ
["生命", "宇宙", "そして万物"]
スキーマに準拠していないこれらの型それぞれに、その型にのみ適用されるキーワードがあります。たとえば、数値型には数値範囲を指定する方法がありますが、これは他の型には適用できません。このリファレンスでは、これらの検証キーワードは、後続の章で対応する型ごとに説明されています。