แปลงตัวอย่าง JSON เป็น struct ของ Rust ที่พร้อมใช้กับ serde ทุก struct derive Debug, Clone, Serialize, Deserialize ชื่อฟิลด์เป็นไปตามธรรมเนียม snake_case ของ Rust และถ้าต่างจากคีย์เดิมจะผูกกลับไปด้วย #[serde(rename)]
เป็นจุดเริ่มต้นเมื่ออยากได้ response ของ reqwest ที่มีไทป์ ต้องการไทป์ request สำหรับ extractor Json<T> ของ axum หรือ actix-web หรือกำลังเขียน CLI ที่พาร์ส JSON ของ log หรือ event
ชื่อไทป์ (เช่น AccessLog).rs แล้วเพิ่ม serde (เปิด feature derive) และ serde_json ใน Cargo.tomlserde_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 ฟิลด์จึงเป็น type_ พร้อม #[serde(rename = "type")] จำนวนเต็มเป็น i64 ไม่ว่าจะขนาดเท่าไร และ latency_ms เป็น f64 ส่วน trace_id มีแต่ null จึงไม่รู้ไทป์และยังเป็น serde_json::Value ให้เปลี่ยนเป็นไทป์จริง เช่น Option<String>
#[derive(Debug, Clone, Serialize, Deserialize)] และฟิลด์ pub ในทุก struct#[serde(rename = "originalKey")] รายฟิลด์เมื่อคีย์ต่างจากชื่อฟิลด์แบบ snake_caseOption<T> พร้อม #[serde(default, skip_serializing_if = "Option::is_none")]null: Option<T> ธรรมดาโดยไม่มี attributei64 สำหรับจำนวนเต็ม, f64 สำหรับทศนิยม, bool, String, Vec<T> และ serde_json::Value สำหรับไทป์ที่ปนกันtype, match หรือ ref ได้ขีดล่างต่อท้าย (type_)pub type Root = Vec<RootItem>;เปลี่ยนการเข้าถึง serde_json::Value อย่าง ["status"].as_i64() เป็น resp.json::<AccessLog>() เพื่อให้ฟิลด์ที่สะกดผิดพังตั้งแต่ตอนคอมไพล์
สร้าง struct จาก JSON ที่ไคลเอนต์ส่งมา แล้วรับเป็น Json(payload): Json<CreateOrder> request ที่ขาดฟิลด์หรือไทป์ผิดจะถูกเฟรมเวิร์กปฏิเสธก่อนถึงโค้ด handler
สร้าง struct จาก log หนึ่งบรรทัด แล้ว deserialize ทีละบรรทัดจาก BufReader::lines() ก็ได้เครื่องมือสรุปผลรายฟิลด์ในไม่กี่บรรทัด
i64 เสมอแม้ค่าจะเล็ก ถ้ารู้ช่วงค่าก็ลดขนาดเอง เช่น status code เป็น u16 หรือตัวนับเป็น u32i64 หรือ String การเปลี่ยนเป็นไทป์ของ chrono หรือ time ต้องเปิด feature serde ของ crate นั้นserde_json::Value เขียน path เต็ม จึงไม่ต้อง use เพิ่ม แต่ยังต้องมี dependency serde_json#[serde(rename_all = "camelCase")] ระดับ struct ถ้าคีย์ใช้ธรรมเนียมเดียวกันทั้งหมด จะรวบเองก็ได้"level": "warn" เหมาะจะเปลี่ยนเป็น enum ภายหลัง#[serde(default)] ด้วย?serde เติม None ให้ Option ที่ไม่มีค่าอยู่แล้ว แต่การระบุ default ชัดเจนทำให้ยังรับคีย์ที่ขาดได้ถ้าภายหลังเปลี่ยนไทป์เป็นอย่าง Vec<T> ส่วน skip_serializing_if จะตัดฟิลด์ที่เป็น None ออกเมื่อเขียน JSON กลับ รูปร่างเดิมจึงคงอยู่
ทั้งสองเป็น Option<T> แต่เฉพาะฟิลด์ที่คีย์อาจไม่มีเท่านั้นที่ได้ attribute default และ skip_serializing_if ฟิลด์ที่มีเสมอแต่บางครั้งเป็น null จะถูกเขียนกลับเป็น null
&str และ lifetime 'de?ฟิลด์แบบ zero-copy (&'a str) อยู่นานกว่าบัฟเฟอร์อินพุตไม่ได้ ซึ่งไม่สะดวกกับการจัดการ response ทั่วไป ค่าเริ่มต้นจึงเป็น String แบบ owned ถ้าเรื่องประสิทธิภาพสำคัญ ให้เปลี่ยนฟิลด์ที่ใช้บ่อยเป็น Cow<'a, str>
Default หรือ PartialEq ได้ไหม?ผลลัพธ์ derive แค่ Debug, Clone, Serialize และ Deserialize เพิ่มเข้าไปในรายการ derive เองได้เมื่อทุกไทป์ของฟิลด์รองรับ (serde_json::Value implement PartialEq)