JSON у Rust
Генеруйте структури Rust з похідними serde на основі зразка JSON. Назви полів перетворюються на snake_case із serde rename, якщо вони відрізняються від ключа JSON; необов’язкові поля та поля, що допускають null, стають типами Option, а значення змішаних типів — serde_json::Value. Для вихідного коду додаються похідні Debug, Clone, PartialEq, Serialize і Deserialize.
Поширені запитання
Як називаються вкладені об’єкти?
Кожен вкладений об’єкт стає окремим типом Rust, названим за ключем, у якому він міститься, у PascalCase, наприклад address стає Address. Об’єкти в масивах отримують однину від ключа масиву, наприклад users стає User. Об’єкти з абсолютно однаковими полями спільно використовують один тип.
Коли поле є необов’язковим?
Якщо масив містить кілька об’єктів і в деяких із них немає певного ключа, це поле є необов’язковим: воно стає Option і пропускається під час серіалізації, якщо має значення None. Ключ, наявний у кожному зразку, є обов’язковим. Для одного об’єкта немає з чим порівнювати, тому всі його ключі обов’язкові.
Як обробляються значення null?
Ключ, який у деяких зразках має значення null, а в інших — певне значення, стає Option відповідного типу. Якщо ключ завжди має значення null, інструмент не може визначити його справжній тип, тому він стає Option<serde_json::Value>; вставте зразок із реальним значенням, щоб отримати точний тип.
Які числові типи використовуються?
Цілі числа стають i64, а дробові — f64. Поле, що містить числа обох типів, стає f64. Замініть i64 на u32, u64 або інший тип, якщо знаєте діапазон.
Що відбувається з ключами, які не є допустимими іменами?
Назви полів перетворюються на snake_case і отримують #[serde(rename = "...")] із початковим ключем, якщо назва відрізняється. Назви, які є зарезервованими словами Rust, як-от type, отримують підкреслення в кінці та rename, щоб структура й надалі читала початковий ключ.
Чи завантажується або зберігається мій JSON?
JSON надсилається на сервер лише для генерації коду для цього запиту й не зберігається. Генератор читає лише структуру та типи значень у вашому зразку, тож перед вставленням ви можете замінити конфіденційні значення на заповнювачі того самого типу.