Konwerter JSON na struktury Rust

Czym jest konwersja JSON na Rust?

Przykłady

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

Jak przekonwertować JSON na struktury Rust

1. 1

   Wklej swój JSON

   Wstaw obiekt JSON, tablicę lub odpowiedź API do pola wejściowego. Konwersja zaczyna się natychmiast.

2. 2

   Dostrój wynik

   Zmień nazwę struktury głównej i przełączaj derywacje serde, Debug i Clone lub widoczność pub, aby dopasować się do stylu swojego crate'a.

3. 3

   Skopiuj lub pobierz

   Przejmij wygenerowany kod Rust jednym kliknięciem i wklej go prosto do swojego projektu.

Common Use Cases

Typowani klienci API

Zamień przykładową odpowiedź REST lub GraphQL w struktury serde dla klienta reqwest lub podobnego, bez ręcznego pisania szablonowego kodu deserializacji.

Parsowanie konfiguracji i fikstur

Generuj struktury dla plików konfiguracyjnych JSON, fikstur testowych lub ładunków webhooków, które musisz deserializować z serde_json.

Szybkie prototypowanie

Wklej nieznany ładunek, aby natychmiast zobaczyć jego kształt jako typy Rust — szybki sposób na poznanie nowego API przed jego podłączeniem.

Jak działa konwersja

Wnioskowanie strukturalne

Każdy obiekt staje się nazwaną strukturą; identyczne kształty są deduplikowane, więc otrzymujesz jedną strukturę, a nie kopie. Tablice obiektów są scalane klucz po kluczu, a klucze nieobecne w niektórych elementach stają się Option<T>.

Poprawne typowanie liczb

Liczby całkowite są mapowane na i64, awansują do u64 powyżej i64::MAX i przechodzą na f64 powyżej u64. Liczby zmiennoprzecinkowe są rozpoznawane po tokenie (1.0, 2e3), więc deserializacja serde nigdy nie zawodzi na niezgodności typu zmiennoprzecinkowego z całkowitym.

Idiomatyczne, kompilowalne identyfikatory

Klucze stają się polami snake_case z #[serde(rename)] wskazującym z powrotem na oryginalny klucz; słowa kluczowe Rust, zduplikowane nazwy i klucze niebędące identyfikatorami są sanityzowane, więc wynik zawsze się kompiluje.

100% po stronie klienta

Parsowanie i generowanie działają w przeglądarce bez wywołań sieciowych, więc twoje dane pozostają prywatne.

Wskazówki dla czystych struktur Rust

Nazwij swoją strukturę główną

Ustaw sensowną nazwę główną (np. User, ApiResponse) zamiast domyślnego Root, aby kod był czytelny.

Dodawaj serde_json tylko wtedy, gdy to konieczne

serde_json::Value pojawia się przy pustych lub mieszanych tablicach oraz polach zawierających wyłącznie null. Nadaj tym polom konkretny typ na podstawie bogatszej próbki, jeśli możesz, lub dodaj serde_json do Cargo.toml.

Przejrzyj Option kontra pola wymagane

Pola są oznaczane jako Option<T> tylko wtedy, gdy próbka je pomija. Wklej reprezentatywny ładunek, aby narzędzie dokładnie wywnioskowało pola wymagane i opcjonalne.

Najczęściej zadawane pytania