JSONからPIKEクラス変換

JSONのサンプルからPikeの型定義を作る

このページでは、JSONの例を入力し、その中に現れるフィールドと値の形をもとにPikeコードを生成できます。JSONのオブジェクトは名前と値の組、配列は順序のある値の並びです。値には文字列、数値、真偽値、null、オブジェクト、配列があります。変換後のコードは、サンプルに含まれる構造をPike側で扱う型定義のたたき台にするためのものです。

たとえば {"name":"Aki","score":92,"active":true,"tags":["dev","docs"],"profile":{"city":"Osaka"}} なら、名前、点数、状態、タグの配列、プロフィールの入れ子が入力例の要素です。出力はこのサンプルから推定されるため、実際のデータ契約そのものではありません。JSONの値の種類はRFC 8259、Pikeの基本型や複合型の用語はPike Manualで確認できます。

値の形とPikeの型を読み分ける

Pikeでは int、float、string などが基本型で、array や mapping などは複合的な値を表す型です。変換結果を読むときは、まず数値や文字列などの単純なフィールドを見てから、配列や入れ子のオブジェクトに対応する宣言をたどると、元のJSONとの対応を追いやすくなります。

ここで扱うのは入力サンプルを基にしたコード生成です。JSONをPikeの実行時データに変換する処理や、受け取ったデータが型定義に適合するかを検証する処理とは異なります。

入力からコードを取り出すまで

1. 入力欄に完全なJSONサンプルを貼り付けます。ページのサンプルを読み込んで置き換えることもできます。複数のフィールドや代表的な配列要素を含めると、確認したい形を入力に反映できます。

2. 必要に応じて整形し、引用符、コロン、カンマ、波括弧や角括弧の対応を確認します。JSONとして読めない場合はエラーが表示され、コード出力は作られません。

3. 型名欄でルート型の名前を設定します。初期値は Root です。Pikeの設定では「型定義のみ」が初期状態で選ばれています。

4. 出力欄のコードを確認し、必要ならコピーまたはファイルとしてダウンロードします。プロジェクトへ取り込む前にPikeのバージョンや既存の命名規則に合わせてください。

入力値を変更すると、その内容に応じて出力も更新されます。エラーになったときは、まずJSONの構文を修正し、出力欄にコードが表示されてから確認を進めてください。

サンプルから生成するときの疑問

生成コードはサンプルに対する下書き

一つのJSON例からは、実データに存在するすべてのフィールド、任意項目、値の変化、バージョン差を判断できません。空配列、null、配列内の異なる形の値など、入力例だけでは型を決めにくいケースは特に出力を確認してください。複数の代表的なJSONを見比べ、必要な型や条件を補うことが大切です。

JSONの構文チェックに通ることは、生成コードのコンパイルや実際のサービス応答との適合を保証しません。コピーまたはダウンロードしたコードは、利用するPike環境でコンパイルやレビューを行ってから使用してください。