Обработка JSON в Rust: serde_json и json

Обработка JSON в Rust: serde_json и работа с данными

JSON (JavaScript Object Notation) остаётся одним из самых популярных форматов обмена данными в веб-разработке, API и конфигурационных файлах. В языке Rust, известном своей производительностью и безопасностью, работа с JSON реализована через мощную экосистему крейтов. Основным инструментом является библиотека serde_json, построенная на фреймворке сериализации serde. В этой статье мы подробно разберём, как парсить, создавать и преобразовывать JSON в Rust, а также рассмотрим альтернативные подходы.

1. Установка и подключение serde_json

Для начала работы добавьте зависимости в файл Cargo.toml:

[dependencies]
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"

serde предоставляет трейты Serialize и Deserialize, а serde_json — конкретную реализацию для JSON. После добавления крейтов можно импортировать их в код:

use serde::{Deserialize, Serialize};
use serde_json::Result;

2. Сериализация структур в JSON

Чтобы преобразовать структуру Rust в JSON, необходимо аннотировать её атрибутами #[derive(Serialize)]. Рассмотрим пример с данными пользователя:

#[derive(Serialize)]
struct User {
    name: String,
    age: u8,
    email: String,
    active: bool,
}

fn main() -> Result<()> {
    let user = User {
        name: "Алексей".to_string(),
        age: 30,
        email: "alex@example.com".to_string(),
        active: true,
    };

    let json = serde_json::to_string(&user)?;
    println!("{}", json);
    // Вывод: {"name":"Алексей","age":30,"email":"alex@example.com","active":true}
    Ok(())
}

Метод serde_json::to_string возвращает Result<String>. Для форматированного вывода используйте serde_json::to_string_pretty.

3. Десериализация JSON в структуры

Обратный процесс — преобразование JSON-строки в структуру Rust. Для этого структура должна реализовывать Deserialize:

#[derive(Deserialize, Debug)]
struct User {
    name: String,
    age: u8,
    email: String,
    active: bool,
}

fn main() -> Result<()> {
    let data = r#"
        {
            "name": "Мария",
            "age": 25,
            "email": "maria@example.com",
            "active": false
        }"#;

    let user: User = serde_json::from_str(data)?;
    println!("{:?}", user);
    // Вывод: User { name: "Мария", age: 25, email: "maria@example.com", active: false }
    Ok(())
}

Если JSON содержит поля, отсутствующие в структуре, или наоборот, используйте атрибуты #[serde(default)] или #[serde(skip_serializing_if = "Option::is_none")].

4. Работа с произвольным JSON (Value)

Иногда структура данных неизвестна заранее. В таких случаях используется перечисление serde_json::Value, которое может представлять любой JSON-тип:

use serde_json::Value;

fn main() -> Result<()> {
    let data = r#"
        {
            "name": "Иван",
            "age": 35,
            "hobbies": ["чтение", "программирование"],
            "address": null
        }"#;

    let v: Value = serde_json::from_str(data)?;

    // Доступ к полям
    if let Some(name) = v.get("name") {
        println!("Имя: {}", name);
    }

    // Извлечение массива
    if let Some(hobbies) = v.get("hobbies").and_then(|h| h.as_array()) {
        for hobby in hobbies {
            println!("Хобби: {}", hobby);
        }
    }

    Ok(())
}

Value поддерживает методы as_str(), as_u64(), as_array() и другие для безопасного извлечения данных.

5. Обработка ошибок и валидация

Библиотека предоставляет детальные сообщения об ошибках. Например, если JSON не соответствует ожидаемой структуре:

fn parse_user(json_str: &str) -> Result<User> {
    let user: User = serde_json::from_str(json_str)?;
    Ok(user)
}

fn main() {
    let bad_json = r#"{"name": "Олег"}"#; // отсутствует age
    match parse_user(bad_json) {
        Ok(user) => println!("{:?}", user),
        Err(e) => eprintln!("Ошибка парсинга: {}", e),
    }
}