JSON в Rust
Создавайте структуры Rust с выводами serde по образцу JSON. Имена полей преобразуются в snake_case; если они отличаются от исходного ключа JSON, добавляется переименование serde. Необязательные поля и поля, допускающие 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, получают подчёркивание в конце и переименование, чтобы структура по-прежнему читала исходный ключ.
Загружается или сохраняется ли мой JSON?
JSON отправляется на сервер только для генерации кода по этому запросу и не сохраняется. Генератор считывает только структуру образца и типы значений, поэтому перед вставкой вы можете заменить конфиденциальные значения заполнителями того же типа.