JSON→Java変換

JSONサンプルからJavaの型を組み立てる

このページでは、入力したJSONオブジェクトまたはオブジェクト配列の形を読み取り、対応するJavaクラスのコードを生成します。JSONのキーはフィールド、入れ子のオブジェクトは関連する型、配列は要素型を持つ配列として表されます。出力はサンプルから推定した型定義で、API仕様そのものを解析するものではありません。RFC 8259ではJSON値としてオブジェクトや配列のほか、数値、文字列、真偽値、nullも定義されています。クラスのフィールドを得たい場合は、キーを含むオブジェクト形式の例を使います。

値の型はサンプルに左右される

文字列は通常String、整数はlong、小数はdouble、真偽値はbooleanとして推定されます。配列はJava配列となり、オブジェクト配列なら要素用のクラスも出力されます。JSONのnullだけでは本来の型を特定できず、Objectになることがあります。日付らしい文字列なども、入力例や推定設定により専用型として扱われる場合があるため、出力を確認してください。Javaの識別子には規則があるため、記号を含むキーやキーワードに当たる名前は調整が必要です（Java言語仕様）。

入力からJavaファイルまで

1. 代表的なJSONを用意する

   通常値に加え、任意項目や配列の複数パターンがあれば含めます。入力欄へ貼り付け、必要なら整形して括弧やカンマを確認します。画面のサンプルを読み込んで形式を試すこともできます。

2. 型名とパッケージを決める

   初期型名はRootです。用途が分かるOrderResponseなどに変更し、出力設定でJavaのパッケージ名をプロジェクトに合わせます。

3. 出力オプションを確認する

   初期状態では型定義のみを出力します。Lombokを使うプロジェクトなら該当オプションを有効にできます。Lombokの@Dataは複数のメソッド生成をまとめる注釈なので、プロジェクト側にLombok設定があるか確認してください（@Dataの公式説明）。

4. 結果を保存して手直しする

   生成内容をコピーするか、型名を使った.javaファイルとして保存します。複数のpublicクラスが出た場合は結果中のクラス名コメントを手がかりにファイルを分けます。Javaのソースファイル名とpublic型名の関係も確認してください（Java言語仕様）。

変換結果についてよくある質問

採用前に仕様と照らし合わせる

出力は入力したサンプルからの推定コードです。API全体の項目、必須条件、数値範囲、互換性を保証するものではありません。

• 1つの例に現れない任意フィールドは推定されません。配列内の型揺れや一部レコードだけにあるキーも、複数の実例で確かめてください。
• JSONの数値から業務上の精度は判断できません。金額や大きな整数は仕様を確認し、必要に応じてBigDecimalなどへ変更します。
• null、空配列、日時らしい文字列、キー名の変換結果を確認してください。生成された名前がJSONキーと異なる場合、シリアライズ時の対応付けが別途必要になることがあります。
• 本番データの秘密情報や個人情報を含むJSONは入力せず、項目名と値を置き換えたサンプルを使ってください。生成コードはプロジェクトの依存関係を自動で整えるものではありません。