Конвертер JSON в структуры Rust

Что такое конвертация JSON в Rust?

Примеры

{"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 в Rust

1. 1

   Вставьте JSON

   Поместите объект JSON, массив или ответ API в поле ввода. Конвертация начинается мгновенно.

2. 2

   Настройте вывод

   Переименуйте корневую структуру и переключайте деривации serde, Debug и Clone или видимость pub, чтобы соответствовать стилю вашего crate.

3. 3

   Скопируйте или скачайте

   Получите сгенерированный Rust одним кликом и вставьте прямо в свой проект.

Common Use Cases

Типизированные клиенты API

Превратите образец ответа REST или GraphQL в структуры serde для клиента reqwest или подобного, не написав вручную шаблонный код десериализации.

Разбор конфигов и фикстур

Генерируйте структуры для конфигурационных файлов JSON, тестовых фикстур или payload'ов вебхуков, которые нужно десериализовать с помощью serde_json.

Быстрое прототипирование

Вставьте незнакомый payload, чтобы мгновенно увидеть его форму как типы Rust — быстрый способ изучить новый API перед его подключением.

Как работает конвертация

Структурный вывод

Каждый объект становится именованной структурой; одинаковые формы дедуплицируются, так что вы получаете одну структуру, а не копии. Массивы объектов сливаются ключ за ключом, а ключи, отсутствующие в части элементов, становятся Option<T>.

Правильная типизация чисел

Целые числа сопоставляются с i64, повышаются до u64 сверх i64::MAX и переходят к f64 за пределами u64. Числа с плавающей точкой определяются по токену (1.0, 2e3), поэтому десериализация serde никогда не падает на несоответствии float в целочисленное поле.

Идиоматичные, компилируемые идентификаторы

Ключи становятся полями snake_case с #[serde(rename)] обратно к исходному ключу; ключевые слова Rust, дублирующиеся имена и ключи, не являющиеся идентификаторами, санируются, поэтому вывод всегда компилируется.

100% на стороне клиента

Разбор и генерация выполняются в браузере без сетевых запросов, поэтому ваши данные остаются приватными.

Советы для чистых структур Rust

Дайте имя корневой структуре

Задайте осмысленное корневое имя (например, User, ApiResponse) вместо стандартного Root для читаемого кода.

Добавляйте serde_json только при необходимости

serde_json::Value появляется для пустых или смешанных массивов и полей, содержащих только null. Дайте таким полям конкретный тип из более богатого образца, если можете, или добавьте serde_json в Cargo.toml.

Проверяйте Option против обязательных полей

Поля помечаются как Option<T> только когда образец их пропускает. Вставьте представительный payload, чтобы инструмент точно определил обязательные и опциональные поля.

Часто задаваемые вопросы