Превращает пример JSON в struct на Rust, готовые для serde. Каждая структура выводит Debug, Clone, Serialize, Deserialize; имена полей следуют соглашению Rust о snake_case и, если отличаются, связываются с исходным ключом через #[serde(rename)].
Хорошая отправная точка, когда нужны типизированные ответы reqwest, тип запроса для экстрактора Json<T> в axum или actix-web или когда вы пишете CLI, разбирающий JSON логов или событий.
Имя типа (например, AccessLog)..rs и добавьте serde (с фичей derive) и serde_json в Cargo.toml.serde_json::from_str::<AccessLog>(&body)? или resp.json::<AccessLog>().await?.{
"timestamp": 1714550400,
"level": "warn",
"type": "http_request",
"status": 503,
"latency_ms": 1250.7,
"headers": [{ "name": "user-agent", "value": "curl/8.4" }],
"trace_id": null
}use serde::{Deserialize, Serialize};
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AccessLog {
pub timestamp: i64,
pub level: String,
#[serde(rename = "type")]
pub type_: String,
pub status: i64,
pub latency_ms: f64,
pub headers: Vec<Header>,
pub trace_id: serde_json::Value,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Header {
pub name: String,
pub value: String,
}
type — ключевое слово Rust, поэтому поле называется type_ с #[serde(rename = "type")]. Целые — i64 независимо от величины, а latency_ms — f64. trace_id всегда null, так что его тип неизвестен и он остаётся serde_json::Value; замените его реальным типом, например Option<String>.
#[derive(Debug, Clone, Serialize, Deserialize)] и поля pub на каждой структуре.#[serde(rename = "originalKey")] на отдельных полях, когда ключ отличается от имени поля в snake_case.Option<T> с #[serde(default, skip_serializing_if = "Option::is_none")].null: просто Option<T> без атрибутов.i64 для целых, f64 для дробных, bool, String, Vec<T> и serde_json::Value для смешанных типов.type, match или ref получают подчёркивание в конце (type_).pub type Root = Vec<RootItem>;.Замените обращения к serde_json::Value вроде ["status"].as_i64() на resp.json::<AccessLog>(), и опечатка в имени поля обнаружится на этапе компиляции.
Сгенерируйте структуру по JSON, который присылает клиент, и принимайте её как Json(payload): Json<CreateOrder>; запросы с отсутствующими полями или полями не того типа фреймворк отклонит ещё до кода обработчика.
Постройте структуру по одной строке лога, затем десериализуйте каждую строку из BufReader::lines() — и инструмент агрегации по полям готов в несколько строк.
i64, какими бы маленькими они ни были. Сузьте их сами там, где диапазон известен, например u16 для кодов статуса или u32 для счётчиков.i64 или String. Переход на типы chrono или time требует включить serde-фичи этих крейтов.serde_json::Value пишет полный путь, так что дополнительный use не нужен, а вот зависимость serde_json нужна.#[serde(rename_all = "camelCase")] на уровне структуры. Если ключи следуют одному соглашению, можете свернуть их сами."level": "warn", — хорошие кандидаты на последующее превращение в enum.#[serde(default)]?serde и так заполняет отсутствующий Option значением None, но явный default продолжит принимать отсутствующие ключи, если вы позже поменяете тип, например на Vec<T>. skip_serializing_if опускает поля None при обратной записи JSON, сохраняя исходную форму.
Оба становятся Option<T>, но атрибуты default и skip_serializing_if получают только поля, ключ которых может отсутствовать. Поле, которое присутствует всегда, но иногда равно null, записывается обратно как null.
&str и время жизни 'de?Zero-copy поля (&'a str) не могут пережить входной буфер, что неудобно при обычной обработке ответов. По умолчанию используется владеющий String; если важна производительность, переведите «горячие» поля на Cow<'a, str>.
Default или PartialEq?Вывод выводит только Debug, Clone, Serialize и Deserialize. Добавьте остальные в список derive сами, если все типы полей их поддерживают (serde_json::Value реализует PartialEq).