JSON for Beginners: A 5-Minute Guide — csv-x.com

著者: マーカス・チェン、フォーチュン500企業向けのAPI駆動システムを構築して12年の経験を持つシニアデータ統合エンジニア

3年前、私はあるジュニアデベロッパーがJSONファイル内の1つの位置を誤ったカンマのために6時間デバッグするのを見ました。APIは常に暗号的な400エラーを返し、ログは役に立たず、失敗するたびにフラストレーションが募りました。私たちが構成ファイルの247行目に埋もれていた小さな句読点の誤りをようやく見つけたとき、安堵感が広がりましたが、このデベロッパーがJSONの基本を適切に習得していなかったことにも気づきました。その瞬間は、私がキャリアの中で見てきたことを明確にしました。JSONは現代のソフトウェア開発において非常に普及しており、私たちはしばしば全員がそれを理解していると仮定しますが、多くのデベロッパーは試行錯誤を通じてばらばらに学び、最初からその洗練された単純さを理解することができていません。

今日、JSON（JavaScript Object Notation）は、最新の公的APIディレクトリの調査によると、約80％のすべてのウェブAPIを支えています。それはサーバーとクライアント間のデータ交換のリンガフランカであり、無数のアプリケーションにおける設定ファイルの基盤であり、MongoDBのようなNoSQLデータベースのデフォルトフォーマットです。ウェブ開発、モバイルアプリ、またはインターネットを介して通信する任意のシステムで作業している場合、あなたは気づいていないかもしれませんが、必ずJSONを使っています。このガイドは、そのジュニアデベロッパーと無数の他の人々がデバッグの時間を何時間も節約できたであろうJSONのしっかりとした基礎を提供します。

JSONとは何か、なぜあなたが気にする必要があるのか？

JSONは、読み書きが容易で、機械にパースおよび生成が簡単な軽量データ交換フォーマットです。2000年代初頭にダグラス・クロックフォードによって作成され、XMLのシンプルな代替として登場しました。XMLは何年もデータ交換を支配していましたが、かなりのオーバーヘッドと複雑さが伴いました。ユーザーオブジェクト（名前、メールアドレス、年齢を含む）を表すためにXML文書が300バイトを必要とするのに対し、JSONは100バイト未満で表現できます。これは66％の削減であり、スケールにおいてより迅速なネットワーク転送と低コストの帯域幅につながります。

JSONの美しさはその最小主義にあります。JSONは6つの構造文字（中括弧、角括弧、コロン、カンマ）ただのみを使用し、6つのデータ型のみをサポートします。この単純さのおかげで、午後だけで仕様全体を学ぶことができますが、情報に対する自然な考え方を反映する複雑なネストされたデータ構造を表現するのに十分な力があります。新規ユーザーにJSONを説明するとき、私は彼らにそれがデータのための普遍的な翻訳者のようなものであると言います。主要なプログラミング言語のすべてがそれを読み書きできるため、PythonバックエンドがJavaScriptフロントエンドと通信する必要があるときや、モバイルアプリがクラウドサービスと通信する必要があるときに最適な選択です。

実際的な影響は非常に大きいです。私の現在の役割では、マイクロサービスアーキテクチャ全体で、毎日約230万のJSON APIリクエストを処理しています。各サービスは、Java、Go、Python、Node.jsで書かれているかどうかにかかわらずJSONで話します。この標準化により、以前のXMLベースのシステムと比較して新しいサービスの統合時間が約40％削減されました。新しい開発者がチームに加わると、データフォーマットがどこでも一貫しているため、数日で任意のサービスに貢献を開始できます。

JSONの優位性は偶然ではなく、そのメリットによるものです。それはプログラミング言語に依存せず、読みやすく、表現力と単純さの完璧なバランスを保っています。特別なツールが必要なバイナリフォーマットとは異なり、任意のテキストエディタでJSONファイルを開いてその構造をすぐに理解できます。冗長なフォーマットであるXMLのように、実際のデータをマークアップの層の下に隠すこともありません。このアクセス可能性と効率の組み合わせは、JSONが現代のAPIのデフォルトの選択肢になった理由を説明しています。APIディレクトリの分析によると、REST APIがJSONを使用するのは約95％のケースです。

6つの基本要素: JSONのデータ型

JSONを理解することは、その6つのデータ型を理解することから始まります。これらはフォーマットの完全な語彙を形成しています。数十のデータ型を持つプログラミング言語とは異なり、JSONは意図的にシンプルに保ち、これがその天才の一部です。これらの6つのタイプは、実際のアプリケーションで遭遇するほぼすべてのデータ構造を表現できます。

文字列は、二重引用符で囲まれた文字の列です。JSONは本当に国際的で、任意のUnicode文字を含むことができます。私の仕事では、グローバルなeコマースプラットフォームで47の異なる言語で商品説明を取り扱い、それはすべてJSON文字列として表現されています。主なルールは、常に二重引用符を使用し、単一引用符は使用しないことです。文字列は次のように表示されます: "こんにちは、世界！" または "価格: ¥299" または "カフェ レジュメ"。

数値は、JSONにおいて非常にシンプルです。整数と浮動小数点数のための別個の型はなく、フォーマット自体にサイズの制限もありません。42、3.14159、-17、または6.022e23（科学表記）を書くことができます。この単純さは、精度が重要な場合に時折混乱を引き起こします。金融アプリケーションは注意が必要で、JSONパーサーは浮動小数点算術のために0.1 + 0.2を0.30000000000000004として表す可能性があります。私が関わった銀行システムでは、常に金銭的な値を串またはセントを表す整数として送信して、これらの精度の問題を回避しています。

ブーリアンは、単に真または偽（小文字、引用符なし）です。フラグや二値状態に最適です。構成ファイルでは、私はブーリアンを広範囲に使用します: "debugMode": true, "enableCaching": false, "requireAuthentication": true。クリーンで明確です。

Nullは値の不在を示し、null（小文字、引用符なし）として書かれます。これは空の文字列やゼロとは異なり、「ここに値はない」を意味します。この区別は、オプションのフィールドを扱う際に重要です。ユーザープロファイルにおいて、"middleName": nullは、ユーザーがミドルネームを持たないことを明確に示しています。これは、"middleName": ""が彼らが持っているが空である可能性があるのに対し、フィールドが完全に存在しないことを示すものとは異なります。

配列は、角括弧で囲まれた順序付きの値のリストで、値はカンマで区切られます。配列は任意のJSONタイプの混合を含むことができます: [1, 2, 3]、["赤", "緑", "青"]、または[42, "混合", true, null]。実際には、配列は一貫性のために通常同じタイプのアイテムを含みます。データエクスポートファイルでは50,000以上の要素を含む配列を見たことがありますが、APIレスポンスでは、応答時間を200ミリ秒未満に保つために通常100アイテムを越えるページングを行います。

オブジェクトは、中括弧で囲まれたキーと値のペアの無秩序なコレクションです。キーは文字列（二重引用符で囲まれる）で、コロンに続いて値が続きます。オブジェクトはJSONが本当に輝く場所であり、複雑なエンティティを表現できます: {"name": "マーカス", "age": 34, "isEngineer": true}。オブジェクトは無限にネストすることができますが、実際には、保守性のためにネストは3〜4レベルに保つことをお勧めします。

JSON構文ルール: 従うべき文法

JSONの構文ルールは厳格であり、この厳格さは実際には特長であり、バグではありません。JSONは（JSONが似ている）JavaScriptとは異なり、解釈や柔軟性の余地はありません。この硬直性は、JSONパーサーが迅速かつ信頼性が高くなることを意味します。成功裏にパースするか、明確なエラーで失敗するかのどちらかです。数百のJSONの問題をデバッグした後、90％の問題はこれらの基本的な構文ルールを違反することから来るとお伝えできます。