JSONとは何か
JSONとは何か
JSON(JavaScript Object Notation)とは、構造化されたデータを表現するための記法です。BLOCKSでは、この記法でデータを表現することが多くあります。
このドキュメントでは、JSONが初めての方を対象に、BLOCKSを利用する上で最低限必要となる事柄について解説しています。詳しい内容および厳密な定義については、「JSONの紹介open_in_new」および「RFC 7159 open_in_new」の文章を参照してください。
JSONの例
下図のようなプロフィール情報があったとします。
以下は、このプロフィール情報をJSONで表現した例です。
{"name":"John Smith","age":35,"languages":["English","Japanese"]}
改行と空白を入れて見やすくもできます。
{ "name": "John Smith", "age": 35, "languages": ["English", "Japanese"] }
どちらも同じデータを表現した例です。
JSONでは、"age": 35
のように、名前("age"
の部分)と値(35
の部分)のペアを基本とし、このペアの集まりでデータ(この場合はプロフィール情報)を表現します。
これらのように、JSONの記法で記述したテキストのことを「JSONテキスト」と言います。
表記方法
JSONで表現できる値は、文字列・数値・配列・オブジェクトと、3種類(true・false・null)のリテラル(文字の並び)です。
値の種類 | 説明 |
---|---|
文字列 | "John Smith" のように、ダブルクオート(" )で文字の並びを囲んだものです。 |
数値 | 35 のように、数値そのものです。10進数で表記します。1.234e-5 のように指数表記もできます。 |
配列 | ["English", "Japanese"] のように、複数個の「値」をひとまとめにしたものです。配列全体を[ と] で囲み、カンマ(, )区切りで「値」を並べます。値のひとつひとつを「要素」と呼びます。 |
オブジェクト |
複数個の「名前」と「値」のペアをひとまとめにしたものです。
|
true | 真偽の真を示します。すべて小文字のtrue でなければなりません。 |
false | 真偽の偽を示します。すべて小文字のfalse でなければなりません。 |
null | 値が空であることを示します。すべて小文字のnull でなければなりません。 |
JSONでは、これらの値を組み合わせて、「JSONの例」で例示したようなデータを表現します。