Ubah JSON menjadi struct Rust!

Masukkan JSON untuk membuat kode struct Rust, termasuk objek bersarang! Mendukung serde Serialize, Deserialize, #[serde(rename)].
JSON
Hasil
 

Ubah JSON menjadi struct Rust!

Ubah contoh JSON menjadi struct Rust yang siap dipakai dengan serde. Setiap struct men-derive Debug, Clone, Serialize, Deserialize; nama field mengikuti konvensi snake_case Rust dan dihubungkan kembali ke key aslinya dengan #[serde(rename)] jika berbeda.

Ini titik awal ketika Anda ingin respons reqwest yang bertipe, butuh tipe request untuk extractor Json<T> di axum atau actix-web, atau sedang menulis CLI yang mem-parse JSON log atau event.

Cara menggunakan

  1. Tempel JSON. Array dengan beberapa item membantu mendeteksi field opsional.
  2. Isi nama struct tingkat atas di Nama tipe (misalnya AccessLog).
  3. Tempel output ke file .rs dan tambahkan serde (dengan feature derive) serta serde_json ke Cargo.toml.
  4. Gunakan lewat serde_json::from_str::<AccessLog>(&body)? atau resp.json::<AccessLog>().await?.

Contoh

Input (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
}
Output (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 adalah keyword Rust, jadi field-nya menjadi type_ dengan #[serde(rename = "type")]. Integer menjadi i64 berapa pun ukurannya, dan latency_ms menjadi f64. trace_id selalu bernilai null, sehingga tipenya tidak diketahui dan tetap serde_json::Value; ganti dengan tipe sebenarnya, misalnya Option<String>.

Fitur yang didukung

  • #[derive(Debug, Clone, Serialize, Deserialize)] dan field pub di setiap struct.
  • #[serde(rename = "originalKey")] per field ketika key berbeda dari nama field snake_case.
  • Field yang tidak ada di sebagian item: Option<T> dengan #[serde(default, skip_serializing_if = "Option::is_none")].
  • Field yang selalu ada tetapi kadang null: Option<T> biasa tanpa atribut.
  • Tipe: i64 untuk integer, f64 untuk desimal, bool, String, Vec<T>, dan serde_json::Value untuk tipe campuran.
  • Key berupa keyword seperti type, match atau ref diberi garis bawah di belakang (type_).
  • Array tingkat atas menghasilkan pub type Root = Vec<RootItem>;.

Kasus penggunaan

Respons reqwest yang bertipe

Ganti lookup serde_json::Value seperti ["status"].as_i64() dengan resp.json::<AccessLog>() agar field yang salah eja gagal saat compile.

Body request di axum atau actix-web

Buat struct dari JSON yang dikirim client dan terima sebagai Json(payload): Json<CreateOrder>; request dengan field yang hilang atau salah tipe ditolak framework sebelum kode handler Anda berjalan.

CLI analisis log JSON Lines

Bangun struct dari satu baris log, lalu deserialize setiap baris dari BufReader::lines() untuk mendapatkan tool agregasi per field hanya dalam beberapa baris.

Catatan dan batasan

  • Integer selalu i64, sekecil apa pun nilainya. Persempit sendiri jika rentangnya diketahui, misalnya u16 untuk status code atau u32 untuk counter.
  • Timestamp dan string tanggal tetap i64 atau String. Beralih ke tipe chrono atau time memerlukan pengaktifan feature serde dari crate tersebut.
  • Output yang memakai serde_json::Value menulis path lengkapnya, jadi tidak perlu use tambahan, tetapi dependensi serde_json tetap diperlukan.
  • Rename dilakukan per field, bukan #[serde(rename_all = "camelCase")] di level struct. Jika key-nya mengikuti satu konvensi, Anda bisa meringkasnya sendiri.
  • Tagged enum tidak dibuat. Field dengan kumpulan nilai yang tetap, seperti "level": "warn", adalah kandidat bagus untuk dijadikan enum setelahnya.

FAQ

Mengapa field opsional juga mendapat #[serde(default)]?

serde sudah mengisi Option yang tidak ada dengan None, tetapi default yang eksplisit tetap menerima key yang hilang jika nanti Anda mengubah tipenya menjadi sesuatu seperti Vec<T>. skip_serializing_if menghilangkan field None saat menulis JSON kembali, sehingga bentuk aslinya terjaga.

Apa beda field yang bisa null dan field yang bisa hilang di output?

Keduanya menjadi Option<T>, tetapi hanya field yang key-nya bisa tidak ada yang mendapat atribut default dan skip_serializing_if. Field yang selalu ada tetapi kadang null ditulis kembali sebagai null.

Mengapa tidak meminjam dengan field &str dan lifetime 'de?

Field zero-copy (&'a str) tidak bisa hidup lebih lama dari buffer input, yang merepotkan untuk penanganan respons pada umumnya. String yang dimiliki adalah default-nya; ganti field yang sering diakses ke Cow<'a, str> jika performa penting.

Bisakah saya menambahkan derive Default atau PartialEq?

Output hanya men-derive Debug, Clone, Serialize dan Deserialize. Tambahkan sendiri ke daftar derive jika semua tipe field mendukungnya (serde_json::Value mengimplementasikan PartialEq).