JSON'dan Rust Struct Dönüştürücü

JSON'dan Rust'a dönüştürme nedir?

Örnekler

{"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,
}

JSON nasıl Rust'a dönüştürülür

1. 1

   JSON'unuzu yapıştırın

   Giriş alanına bir JSON nesnesi, dizisi veya API yanıtı bırakın. Dönüştürme anında başlar.

2. 2

   Çıktıyı ayarlayın

   Kök struct'ı yeniden adlandırın ve crate'inizin stiline uyması için serde derive'lerini, Debug ve Clone'u veya pub görünürlüğünü açıp kapatın.

3. 3

   Kopyalayın veya indirin

   Oluşturulan Rust'ı tek tıkla alın ve doğrudan projenize yapıştırın.

Common Use Cases

Türlenmiş API istemcileri

Bir REST veya GraphQL yanıtı örneğini, elle deserializasyon tekrar kodu yazmadan bir reqwest ya da benzeri istemci için serde struct'larına dönüştürün.

Yapılandırma ve fikstür ayrıştırma

serde_json ile deserialize etmeniz gereken JSON yapılandırma dosyaları, test fikstürleri veya webhook yükleri için struct'lar oluşturun.

Hızlı prototipleme

Bilmediğiniz bir yükü yapıştırıp biçimini anında Rust türleri olarak görün — yeni bir API'yi bağlamadan önce keşfetmenin hızlı bir yolu.

Dönüştürme nasıl çalışır

Yapısal çıkarım

Her nesne adlandırılmış bir struct olur; aynı biçimler tekilleştirilir, böylece kopyalar değil tek bir struct elde edersiniz. Nesne dizileri anahtar anahtar birleştirilir ve bazı öğelerde bulunmayan anahtarlar Option<T> olur.

Doğru sayı türleme

Tam sayılar i64'e eşlenir, i64::MAX'ın ötesinde u64'e yükselir ve u64'ün ötesinde f64'e geri düşer. Kayan sayılar tokenden algılanır (1.0, 2e3), böylece serde deserializasyonu bir kayan sayının tam sayı alanına uyumsuzluğunda asla başarısız olmaz.

İdiomatik, derlenebilir tanımlayıcılar

Anahtarlar #[serde(rename)] ile orijinal anahtara geri dönen snake_case alanları olur; Rust anahtar sözcükleri, yinelenen adlar ve tanımlayıcı olmayan anahtarlar temizlenir, böylece çıktı her zaman derlenir.

%100 istemci tarafı

Ayrıştırma ve oluşturma, ağ çağrısı olmadan tarayıcınızda çalışır; böylece verileriniz gizli kalır.

Temiz Rust struct'ları için ipuçları

Kök struct'ınızı adlandırın

Okunabilir kod için varsayılan Root yerine anlamlı bir kök adı belirleyin (örneğin User, ApiResponse).

serde_json'u yalnızca gerektiğinde ekleyin

serde_json::Value, boş veya karışık türde diziler ve yalnızca null içeren alanlar için ortaya çıkar. Yapabiliyorsanız bu alanlara daha zengin bir örnekten somut bir tür verin ya da Cargo.toml dosyanıza serde_json ekleyin.

Option'a karşı zorunlu alanları gözden geçirin

Alanlar yalnızca bir örnek onları atladığında Option<T> olarak işaretlenir. Aracın zorunlu ve isteğe bağlı alanları doğru çıkarabilmesi için temsili bir yük yapıştırın.

Sıkça Sorulan Sorular