Konverter JSON ke Struct Rust

Apa itu konversi JSON ke Rust?

Contoh

{"id":101,"name":"Ada Lovelace","email":"ada@example.com","active":true,"roles":["admin","user"]}

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Root {
    pub id: i64,
    pub name: String,
    pub email: String,
    pub active: bool,
    pub roles: Vec<String>,
}

{"repo":"serde","owner":{"login":"dtolnay","id":100}}

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Root {
    pub repo: String,
    pub owner: Owner,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Owner {
    pub login: String,
    pub id: i64,
}

{"users":[{"id":1,"nick":"x"},{"id":2}]}

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Root {
    pub users: Vec<User>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct User {
    pub id: i64,
    pub nick: Option<String>,
}

{"login":"octocat","publicRepos":15,"followerCount":9001,"createdAt":"2011-01-25"}

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Root {
    pub login: String,
    #[serde(rename = "publicRepos")]
    pub public_repos: i64,
    #[serde(rename = "followerCount")]
    pub follower_count: i64,
    #[serde(rename = "createdAt")]
    pub created_at: String,
}

Cara mengonversi JSON ke Rust

1. 1

   Tempel JSON Anda

   Masukkan objek JSON, array, atau respons API ke kolom input. Konversi dimulai seketika.

2. 2

   Setel output

   Ganti nama struct root dan aktifkan derive serde, Debug dan Clone, atau visibilitas pub agar sesuai gaya crate Anda.

3. 3

   Salin atau unduh

   Ambil Rust yang dihasilkan dengan satu klik dan tempel langsung ke proyek Anda.

Common Use Cases

Klien API bertipe

Ubah sampel respons REST atau GraphQL menjadi struct serde untuk klien reqwest atau serupa tanpa menulis boilerplate deserialisasi dengan tangan.

Parsing konfigurasi dan fixture

Hasilkan struct untuk file konfigurasi JSON, fixture uji, atau payload webhook yang perlu Anda deserialisasi dengan serde_json.

Prototipe cepat

Tempel payload yang tak dikenal untuk langsung melihat bentuknya sebagai tipe Rust — cara cepat menjelajahi API baru sebelum menghubungkannya.

Cara kerja konversi

Inferensi struktural

Setiap objek menjadi struct bernama; bentuk yang identik dideduplikasi sehingga Anda mendapat satu struct, bukan salinan. Array objek digabung kunci demi kunci, dan kunci yang absen dari sebagian item menjadi Option<T>.

Penentuan tipe angka yang benar

Bilangan bulat dipetakan ke i64, naik ke u64 setelah i64::MAX, dan turun ke f64 di luar u64. Float dideteksi dari token (1.0, 2e3) sehingga deserialisasi serde tak pernah gagal karena ketidakcocokan float-ke-integer.

Identifier idiomatik yang dapat dikompilasi

Kunci menjadi field snake_case dengan #[serde(rename)] kembali ke kunci asli; kata kunci Rust, nama duplikat, dan kunci non-identifier disterilkan agar output selalu terkompilasi.

100% sisi klien

Parsing dan pembuatan berjalan di browser Anda tanpa panggilan jaringan, sehingga data Anda tetap privat.

Tips untuk struct Rust yang rapi

Beri nama struct root Anda

Tetapkan nama root yang bermakna (mis. User, ApiResponse) alih-alih Root bawaan agar kode mudah dibaca.

Tambahkan serde_json hanya saat perlu

serde_json::Value muncul untuk array kosong atau bertipe campuran dan field yang hanya null. Beri field tersebut tipe konkret dari sampel yang lebih kaya jika bisa, atau tambahkan serde_json ke Cargo.toml.

Tinjau Option vs wajib

Field ditandai Option<T> hanya ketika sebuah sampel menghilangkannya. Tempel payload yang representatif agar alat menyimpulkan field wajib dan opsional secara akurat.

Pertanyaan yang sering diajukan