JSONをRustのstructに変換!

JSONを入力すると、ネストしたオブジェクトまでRustのstructコードに変換します!serde Serialize, Deserialize, #[serde(rename)] 対応。
JSON
結果
 

JSONをRustのstructに変換!

JSON のサンプルを、serde ですぐ使える Rust の struct に変換します。各構造体は Debug, Clone, Serialize, Deserialize を derive し、フィールド名は Rust の snake_case の規約に従い、元のキーと異なる場合は #[serde(rename)] で結び付けます。

reqwest のレスポンスを型付きで扱いたいとき、axum や actix-web の Json<T> エクストラクター用のリクエスト型が必要なとき、ログやイベントの JSON を解析する CLI を書くときの出発点になります。

使い方

  1. JSON を貼り付けます。要素が複数ある配列なら、省略可能なフィールドを検出しやすくなります。
  2. 型名 にトップレベルの構造体名を入力します(例: AccessLog)。
  3. 出力を .rs ファイルに貼り付け、Cargo.toml に serde(derive フィーチャー付き)と serde_json を追加します。
  4. serde_json::from_str::<AccessLog>(&body)? や resp.json::<AccessLog>().await? で使います。

例

入力 (JSON)
{
  "timestamp": 1714550400,
  "level": "warn",
  "type": "http_request",
  "status": 503,
  "latency_ms": 1250.7,
  "headers": [{ "name": "user-agent", "value": "curl/8.4" }],
  "trace_id": null
}
出力 (Rust · serde)
use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AccessLog {
    pub timestamp: i64,
    pub level: String,
    #[serde(rename = "type")]
    pub type_: String,
    pub status: i64,
    pub latency_ms: f64,
    pub headers: Vec<Header>,
    pub trace_id: serde_json::Value,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Header {
    pub name: String,
    pub value: String,
}

type は Rust のキーワードなので、フィールドは #[serde(rename = "type")] 付きの type_ になります。整数は大きさに関係なく i64 で、latency_ms は f64 です。trace_id は常に null なので型がわからず serde_json::Value のままです。Option<String> など実際の型に置き換えてください。

対応機能

  • すべての構造体に #[derive(Debug, Clone, Serialize, Deserialize)] と pub フィールドを付けます。
  • キーが snake_case のフィールド名と異なる場合は、フィールドごとに #[serde(rename = "originalKey")] を付けます。
  • 一部の要素にないフィールド: #[serde(default, skip_serializing_if = "Option::is_none")] 付きの Option<T>。
  • 常にあるが時々 null になるフィールド: 属性なしの単なる Option<T>。
  • 型: 整数は i64、小数は f64、bool、String、Vec<T>、型が混在する場合は serde_json::Value。
  • type、match、ref のようなキーワードのキーには末尾にアンダースコアが付きます(type_)。
  • トップレベルが配列のときは pub type Root = Vec<RootItem>; を出力します。

利用シーン

型付きの reqwest レスポンス

["status"].as_i64() のような serde_json::Value の参照を resp.json::<AccessLog>() に置き換えれば、フィールド名の綴り間違いがコンパイル時に失敗として表れます。

axum や actix-web のリクエストボディ

クライアントが送る JSON から構造体を生成し、Json(payload): Json<CreateOrder> として受け取ります。フィールドが欠けていたり型が違ったりするリクエストは、ハンドラーのコードが動く前にフレームワークが拒否します。

JSON Lines のログ解析 CLI

ログ1行から構造体を作り、BufReader::lines() の各行をデシリアライズすれば、数行でフィールドごとの集計ツールになります。

注意点と制限

  • 整数はどれだけ小さくても常に i64 です。u16 のステータスコードや u32 のカウンターなど、範囲がわかっているものは自分で狭めてください。
  • タイムスタンプや日付の文字列は i64 や String のままです。chrono や time の型に切り替えるには、それらのクレートの serde フィーチャーを有効にする必要があります。
  • serde_json::Value を使う出力はフルパスで書くので追加の use は不要ですが、serde_json への依存は必要です。
  • 名前の変更は、構造体単位の #[serde(rename_all = "camelCase")] ではなくフィールド単位です。キーが1つの規約に従っているなら、自分でまとめても構いません。
  • タグ付き enum は生成しません。"level": "warn" のように値の種類が決まっているフィールドは、あとで enum にするのに向いています。

よくある質問

省略可能なフィールドにも #[serde(default)] が付くのはなぜですか?

serde は欠けた Option をもともと None で埋めますが、default を明示しておけば、あとで型を Vec<T> などに変えてもキーの欠落を受け付け続けます。skip_serializing_if は JSON に書き戻すときに None のフィールドを省き、元の形を保ちます。

null になりうるフィールドと欠けうるフィールドは、出力でどう違いますか?

どちらも Option<T> になりますが、default と skip_serializing_if の属性が付くのはキーが欠けうるフィールドだけです。常にあるが時々 null になるフィールドは、null として書き戻されます。

&str のフィールドと 'de ライフタイムで借用しないのはなぜですか?

ゼロコピーのフィールド(&'a str)は入力バッファより長く生きられないため、一般的なレスポンス処理では扱いにくくなります。既定は所有権を持つ String です。性能が重要なら、よく使うフィールドを Cow<'a, str> に切り替えてください。

Default や PartialEq の derive を追加できますか?

出力が derive するのは Debug、Clone、Serialize、Deserialize だけです。すべてのフィールドの型が対応していれば、derive リストに自分で追加してください(serde_json::Value は PartialEq を実装しています)。