JSON のサンプルを、serde ですぐ使える Rust の struct に変換します。各構造体は Debug, Clone, Serialize, Deserialize を derive し、フィールド名は Rust の snake_case の規約に従い、元のキーと異なる場合は #[serde(rename)] で結び付けます。
reqwest のレスポンスを型付きで扱いたいとき、axum や actix-web の Json<T> エクストラクター用のリクエスト型が必要なとき、ログやイベントの JSON を解析する CLI を書くときの出発点になります。
型名 にトップレベルの構造体名を入力します(例: AccessLog)。.rs ファイルに貼り付け、Cargo.toml に serde(derive フィーチャー付き)と serde_json を追加します。serde_json::from_str::<AccessLog>(&body)? や resp.json::<AccessLog>().await? で使います。{
"timestamp": 1714550400,
"level": "warn",
"type": "http_request",
"status": 503,
"latency_ms": 1250.7,
"headers": [{ "name": "user-agent", "value": "curl/8.4" }],
"trace_id": null
}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 フィールドを付けます。#[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>; を出力します。["status"].as_i64() のような serde_json::Value の参照を resp.json::<AccessLog>() に置き換えれば、フィールド名の綴り間違いがコンパイル時に失敗として表れます。
クライアントが送る JSON から構造体を生成し、Json(payload): Json<CreateOrder> として受け取ります。フィールドが欠けていたり型が違ったりするリクエストは、ハンドラーのコードが動く前にフレームワークが拒否します。
ログ1行から構造体を作り、BufReader::lines() の各行をデシリアライズすれば、数行でフィールドごとの集計ツールになります。
i64 です。u16 のステータスコードや u32 のカウンターなど、範囲がわかっているものは自分で狭めてください。i64 や String のままです。chrono や time の型に切り替えるには、それらのクレートの serde フィーチャーを有効にする必要があります。serde_json::Value を使う出力はフルパスで書くので追加の use は不要ですが、serde_json への依存は必要です。#[serde(rename_all = "camelCase")] ではなくフィールド単位です。キーが1つの規約に従っているなら、自分でまとめても構いません。"level": "warn" のように値の種類が決まっているフィールドは、あとで enum にするのに向いています。#[serde(default)] が付くのはなぜですか?serde は欠けた Option をもともと None で埋めますが、default を明示しておけば、あとで型を Vec<T> などに変えてもキーの欠落を受け付け続けます。skip_serializing_if は JSON に書き戻すときに None のフィールドを省き、元の形を保ちます。
どちらも 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 を実装しています)。