Tukar JSON kepada struct Rust!

Masukkan JSON untuk menjana kod struct Rust, termasuk objek bersarang! Menyokong serde Serialize, Deserialize, #[serde(rename)].
JSON
Hasil
 

Tukar JSON kepada struct Rust!

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.

Cara menggunakan

  1. Tampal JSON. Tatasusunan dengan beberapa item membantu mengesan medan pilihan.
  2. Masukkan nama struct peringkat atas dalam Nama jenis (contohnya AccessLog).
  3. Tampal output ke dalam fail .rs dan tambah serde (dengan feature derive) serta serde_json ke Cargo.toml.
  4. Gunakannya melalui 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 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>.

Ciri yang disokong

  • #[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.
  • Medan yang tiada dalam sesetengah item: Option<T> dengan #[serde(default, skip_serializing_if = "Option::is_none")].
  • Medan yang sentiasa ada tetapi kadangkala null: Option<T> biasa tanpa atribut.
  • Jenis: i64 untuk integer, f64 untuk perpuluhan, bool, String, Vec<T>, dan serde_json::Value untuk jenis bercampur.
  • Kunci yang merupakan kata kunci seperti type, match atau ref diberi garis bawah di hujung (type_).
  • Tatasusunan peringkat atas menghasilkan pub type Root = Vec<RootItem>;.

Kes penggunaan

Respons reqwest yang bertaip

Gantikan carian serde_json::Value seperti ["status"].as_i64() dengan resp.json::<AccessLog>() supaya salah ejaan nama medan gagal semasa kompil.

Badan permintaan dalam axum atau actix-web

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.

CLI analisis log JSON Lines

Bina struct daripada satu baris log, kemudian nyahsiri setiap baris daripada BufReader::lines() untuk mendapatkan alat agregasi mengikut medan dalam beberapa baris kod sahaja.

Nota dan had

  • Integer sentiasa i64, walau sekecil mana pun. Kecilkan sendiri jika julatnya diketahui, contohnya kod status u16 atau pembilang u32.
  • Cap masa dan rentetan tarikh kekal i64 atau String. Untuk beralih ke jenis chrono atau time, anda perlu mengaktifkan feature serde crate tersebut.
  • Output yang menggunakan serde_json::Value menulis laluan penuh, jadi tiada use tambahan diperlukan, tetapi kebergantungan serde_json tetap diperlukan.
  • Penamaan semula dibuat bagi setiap medan, bukan #[serde(rename_all = "camelCase")] di peringkat struct. Jika kunci mengikut satu konvensyen, anda boleh menggabungkannya sendiri.
  • Enum bertag tidak dijana. Medan dengan set nilai tetap, seperti "level": "warn", sesuai dijadikan enum kemudian.

Soalan lazim

Mengapa medan pilihan turut mendapat #[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.

Apakah beza medan yang boleh null dan medan yang hilang dalam output?

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.

Mengapa tidak meminjam dengan medan &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.

Bolehkah saya menambah derive 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).