JSON→Dartクラス変換

JSONのサンプルからDartモデルを組み立てる

JSON→Dartクラス変換は、入力したJSONオブジェクトまたは配列の形を読み取り、対応するDartの型定義やモデルコードを生成するツールです。APIレスポンスの項目を手作業でクラスに写す前に、構造を見える形にして作業のたたき台を作れます。JSONのキーはプロパティ名に、文字列・数値・真偽値・配列・入れ子のオブジェクトはそれぞれの型や関連する型に反映されます。配列内にオブジェクトがあれば、その要素の構造もモデルに含まれます。

JSONはデータ交換に使うテキスト形式です。DartではJSONをデコードすると、オブジェクトはマップ、配列はリストとして扱われます。モデルクラスを用意すると、アプリ内で値を型付きのフィールドとして扱いやすくなります。Dart公式資料では、JSON文字列とDartオブジェクトの変換に dart:convert を案内し、注釈を使う生成方式として json_serializable も紹介しています。

サンプルから推論する型とnull安全性

生成される型は、貼り付けたサンプルに現れた値から推論されます。たとえば {"name":"Mika","age":28,"active":true} なら、文字列・整数・真偽値に対応するフィールド構造を確認できます。オプションで型定義だけに絞るほか、Freezed互換、Hiveアダプター、JSONアノテーション、finalプロパティ、copyWith の生成を切り替えられます。初期設定ではnull安全性とJSONアノテーションが有効です。

Dartのnull安全性では、通常の型はnullを受け取らず、型名に ? を付けるとnullを許す型になります。サンプルでnullや省略項目がどのように表現されるかを見ながら設定を確認してください。ここで得られるのは入力例に基づくコード案であり、サーバーが返しうる全パターンや必須条件を自動で把握するものではありません。

入力からコードを持ち帰るまで

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

   実際のAPIレスポンスから、必要なキーや入れ子、配列要素が含まれる有効なJSONを貼り付けます。複数レコードで項目が異なる場合は、その違いが分かるサンプルを配列にまとめると確認しやすくなります。

2. 型名と生成設定を決める

   ルートの型名をプロジェクト内で使う名前に変更します。null安全性やJSONアノテーションなど基本設定を確認し、必要なら詳細設定で型定義のみ、Freezed、Hive、final、copyWithを選びます。選択によって出力内容が変わります。

3. 結果を確認して保存する

   入れ子の型、リストの要素型、プロパティ名、nullを許す型を見直します。問題なければコードをコピーするか、型名を使った .dart ファイルとしてダウンロードします。

入力の変更に応じてコードが更新されます。「フォーマット」はJSONの見た目を整え、「サンプル」は例を読み込みます。構文エラーが出る場合は、キーと文字列を二重引用符で囲み、末尾のカンマやコメントを取り除いてください。

入力形式と出力コードについて

生成結果を採用する前の確認

出力は入力サンプルの形から推論したコード草案です。サンプルにない任意項目、フィールドごとの業務ルール、値の範囲、APIのバージョン差は保証されません。単一レコードだけでは、他の応答で現れる項目やnullの可能性を表せないことがあります。代表性のある例を用意し、型・null許容・フィールド名をAPI契約に照らして修正してください。

このツールはDartコードのコンパイルやアプリ上の動作を検証しません。Freezed、Hive、JSONアノテーションを有効にした場合は、出力がプロジェクトの依存パッケージと生成設定に合うかを確認し、実際のビルドやテストで確かめてください。機密性のある実データを入力する場合は、組織のデータ取扱いルールに従い、個人情報や認証情報を含まないサンプルに置き換えることを検討してください。