Chuyển JSON thành struct Rust!

Nhập JSON để tạo mã struct Rust, kể cả các object lồng nhau! Hỗ trợ serde Serialize, Deserialize, #[serde(rename)].
JSON
Kết quả
 

Chuyển JSON thành struct Rust!

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.

Cách sử dụng

  1. Dán JSON. Một mảng nhiều phần tử giúp công cụ phát hiện field tùy chọn.
  2. Nhập tên struct cấp cao nhất vào Tên kiểu (ví dụ AccessLog).
  3. Dán output vào file .rs và thêm serde (với feature derive) cùng serde_json vào Cargo.toml.
  4. Dùng qua serde_json::from_str::<AccessLog>(&body)? hoặc resp.json::<AccessLog>().await?.

Ví dụ

Đầu vào (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
}
Đầu ra (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 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>.

Tính năng hỗ trợ

  • #[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.
  • Field thiếu ở một số phần tử: Option<T> kèm #[serde(default, skip_serializing_if = "Option::is_none")].
  • Field luôn có mặt nhưng đôi khi là null: Option<T> thuần, không có attribute.
  • Kiểu: 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.
  • Key trùng từ khóa như type, match hay ref được thêm gạch dưới ở cuối (type_).
  • Mảng ở cấp cao nhất cho ra pub type Root = Vec<RootItem>;.

Trường hợp sử dụng

Response reqwest có kiểu

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.

Body request trong axum hoặc actix-web

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.

CLI phân tích log JSON Lines

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.

Lưu ý và giới hạn

  • Số nguyên luôn là 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.
  • Timestamp và chuỗi ngày tháng vẫn là 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 đó.
  • Output dùng 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.
  • Đổi tên được làm theo từng field chứ không phải #[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.
  • Không tạo tagged enum. Field có tập giá trị cố định, như "level": "warn", là ứng viên tốt để đổi thành enum sau đó.

Câu hỏi thường gặp

Vì sao field tùy chọn còn có #[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.

Field có thể null và field có thể thiếu khác nhau thế nào trong output?

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.

Sao không mượn bằng field &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.

Có thêm derive 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).