Tukar sampel JSON kepada struct Rust yang sedia untuk serde. Setiap struct men-derive Debug, Clone, Serialize, Deserialize; nama medan mengikut konvensyen snake_case Rust dan dipautkan semula kepada kunci asal dengan #[serde(rename)] apabila berbeza.
Ia titik permulaan apabila anda mahukan respons reqwest yang bertaip, memerlukan jenis permintaan untuk extractor Json<T> axum atau actix-web, atau sedang menulis CLI yang menghurai JSON log atau event.
Nama jenis (contohnya AccessLog)..rs dan tambah serde (dengan feature derive) serta serde_json ke Cargo.toml.serde_json::from_str::<AccessLog>(&body)? atau 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 ialah kata kunci Rust, jadi medannya ialah type_ dengan #[serde(rename = "type")]. Integer ialah i64 tanpa mengira saiz, dan latency_ms ialah f64. trace_id sentiasa null, jadi jenisnya tidak diketahui dan ia kekal serde_json::Value; gantikan dengan jenis sebenar, contohnya Option<String>.
#[derive(Debug, Clone, Serialize, Deserialize)] dan medan pub pada setiap struct.#[serde(rename = "originalKey")] bagi setiap medan apabila kunci berbeza daripada nama medan snake_case.Option<T> dengan #[serde(default, skip_serializing_if = "Option::is_none")].null: Option<T> biasa tanpa atribut.i64 untuk integer, f64 untuk perpuluhan, bool, String, Vec<T>, dan serde_json::Value untuk jenis bercampur.type, match atau ref diberi garis bawah di hujung (type_).pub type Root = Vec<RootItem>;.Gantikan carian serde_json::Value seperti ["status"].as_i64() dengan resp.json::<AccessLog>() supaya salah ejaan nama medan gagal semasa kompil.
Jana struct daripada JSON yang dihantar klien dan terimanya sebagai Json(payload): Json<CreateOrder>; permintaan dengan medan yang hilang atau salah jenis ditolak oleh framework sebelum kod handler anda berjalan.
Bina struct daripada satu baris log, kemudian nyahsiri setiap baris daripada BufReader::lines() untuk mendapatkan alat agregasi mengikut medan dalam beberapa baris kod sahaja.
i64, walau sekecil mana pun. Kecilkan sendiri jika julatnya diketahui, contohnya kod status u16 atau pembilang u32.i64 atau String. Untuk beralih ke jenis chrono atau time, anda perlu mengaktifkan feature serde crate tersebut.serde_json::Value menulis laluan penuh, jadi tiada use tambahan diperlukan, tetapi kebergantungan serde_json tetap diperlukan.#[serde(rename_all = "camelCase")] di peringkat struct. Jika kunci mengikut satu konvensyen, anda boleh menggabungkannya sendiri."level": "warn", sesuai dijadikan enum kemudian.#[serde(default)]?serde sudah mengisi Option yang hilang dengan None, tetapi default yang eksplisit memastikan kunci yang hilang terus diterima jika anda kemudian menukar jenisnya kepada sesuatu seperti Vec<T>. skip_serializing_if meninggalkan medan None semasa menulis semula JSON, mengekalkan bentuk asal.
Kedua-duanya menjadi Option<T>, tetapi hanya medan yang kuncinya boleh tiada mendapat atribut default dan skip_serializing_if. Medan yang sentiasa ada tetapi kadangkala null ditulis semula sebagai null.
&str dan lifetime 'de?Medan zero-copy (&'a str) tidak boleh hidup lebih lama daripada buffer input, yang menyusahkan untuk pengendalian respons biasa. String yang dimiliki menjadi lalai; tukar medan yang kerap digunakan kepada Cow<'a, str> jika prestasi penting.
Default atau PartialEq?Output hanya men-derive Debug, Clone, Serialize dan Deserialize. Tambah sendiri ke senarai derive apabila semua jenis medan menyokongnya (serde_json::Value melaksanakan PartialEq).