Biến một mẫu JSON thành các struct Rust dùng ngay với serde. Mỗi struct derive Debug, Clone, Serialize, Deserialize; tên field theo quy ước snake_case của Rust và được gắn lại với key gốc bằng #[serde(rename)] khi khác nhau.
Đây là điểm khởi đầu khi bạn muốn response reqwest có kiểu, cần kiểu request cho extractor Json<T> của axum hay actix-web, hoặc đang viết CLI parse JSON của log hay event.
Tên kiểu (ví dụ AccessLog)..rs và thêm serde (với feature derive) cùng serde_json vào Cargo.toml.serde_json::from_str::<AccessLog>(&body)? hoặc 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 là từ khóa Rust nên field là type_ kèm #[serde(rename = "type")]. Số nguyên là i64 bất kể độ lớn, còn latency_ms là f64. trace_id chỉ toàn null nên không rõ kiểu và vẫn là serde_json::Value; hãy thay bằng kiểu thật, ví dụ Option<String>.
#[derive(Debug, Clone, Serialize, Deserialize)] và field pub trên mọi struct.#[serde(rename = "originalKey")] trên từng field khi key khác tên field snake_case.Option<T> kèm #[serde(default, skip_serializing_if = "Option::is_none")].null: Option<T> thuần, không có attribute.i64 cho số nguyên, f64 cho số thập phân, bool, String, Vec<T>, và serde_json::Value cho kiểu lẫn lộn.type, match hay ref được thêm gạch dưới ở cuối (type_).pub type Root = Vec<RootItem>;.Thay các lần tra serde_json::Value như ["status"].as_i64() bằng resp.json::<AccessLog>() để field gõ sai bị bắt ngay lúc compile.
Tạo struct từ JSON mà client gửi lên và nhận nó dưới dạng Json(payload): Json<CreateOrder>; request thiếu field hoặc sai kiểu bị framework từ chối trước khi code handler chạy.
Dựng struct từ một dòng log, rồi deserialize từng dòng từ BufReader::lines() là có công cụ tổng hợp theo field chỉ trong vài dòng.
i64, dù nhỏ đến đâu. Hãy tự thu hẹp ở chỗ đã biết phạm vi, ví dụ mã trạng thái u16 hay bộ đếm u32.i64 hoặc String. Chuyển sang kiểu của chrono hay time cần bật feature serde của các crate đó.serde_json::Value ghi đường dẫn đầy đủ, nên không cần thêm use, nhưng vẫn cần dependency serde_json.#[serde(rename_all = "camelCase")] ở cấp struct. Nếu key theo một quy ước duy nhất, bạn có thể tự gộp lại."level": "warn", là ứng viên tốt để đổi thành enum sau đó.#[serde(default)]?serde vốn đã điền None cho Option bị thiếu, nhưng default tường minh giúp vẫn chấp nhận key vắng mặt nếu sau này bạn đổi kiểu thành thứ như Vec<T>. skip_serializing_if bỏ field None khi ghi JSON ra, giữ nguyên hình dạng ban đầu.
Cả hai đều thành Option<T>, nhưng chỉ field có key có thể vắng mặt mới nhận attribute default và skip_serializing_if. Field luôn có mặt nhưng đôi khi là null sẽ được ghi ngược ra là null.
&str và lifetime 'de?Field zero-copy (&'a str) không thể sống lâu hơn buffer đầu vào, điều này bất tiện khi xử lý response thông thường. String sở hữu là mặc định; hãy đổi các field nóng sang Cow<'a, str> nếu hiệu năng quan trọng.
Default hay PartialEq được không?Output chỉ derive Debug, Clone, Serialize và Deserialize. Hãy tự thêm vào danh sách derive khi mọi kiểu field đều hỗ trợ (serde_json::Value có hiện thực PartialEq).