Serde para Rust: guía completa con ejemplos

¿Qué es Serde y para qué sirve?

Serde (abreviatura de Serialization/Deserialization) es un framework para la serialización y deserialización de estructuras de datos en el lenguaje Rust. Es el estándar de facto para trabajar con formatos de datos en el ecosistema de Rust. La biblioteca permite convertir tipos complejos de Rust (estructuras, enumeraciones, vectores, tablas hash) en varios formatos de texto y binarios (JSON, YAML, TOML, BSON, MessagePack, CBOR, y muchos otros) y viceversa.

La filosofía principal de Serde es rendimiento sin concesiones. Utiliza el potente sistema de macros de Rust para generar código altamente optimizado en tiempo de compilación, lo que la convierte en una de las bibliotecas de serialización más rápidas entre todos los lenguajes de programación. Serde no está vinculada a ningún formato específico: proporciona los traits abstractos Serialize y Deserialize, y los formatos concretos se implementan en crates separados (por ejemplo, serde_json, serde_yaml).

¿Para qué sirve Serde?

\n
• Guardar estado: escribir configuraciones, partidas guardadas, caché en disco
\n
• Protocolos de red: intercambio de datos entre cliente y servidor (REST API, WebSocket)
\n
• Archivos de configuración: leer ajustes desde JSON/YAML/TOML
\n
• Bases de datos: serialización de registros para almacenar en Redis, MongoDB y otras bases de datos
\n
• Comunicación entre procesos: transferencia de datos entre procesos a través de pipes o sockets
\n

Instalación

Serde se instala a través del gestor de paquetes Cargo, integrado en Rust. Para empezar, agregue las dependencias en el archivo Cargo.toml:

[dependencies]\nserde = { version = "1.0", features = ["derive"] }\nserde_json = "1.0"

Explicación de las dependencias:

\n
• serde — el núcleo de la biblioteca con los traits Serialize y Deserialize. La bandera features = ["derive"] habilita el soporte para la macro #[derive(Serialize, Deserialize)].
\n
• serde_json — la implementación del formato JSON. De manera similar se agregan serde_yaml, serde_toml, bincode y otros.
\n

Si trabaja con Rust 2021 edition o superior, simplemente agregue estas líneas. Para instalar una versión específica, indique el número, por ejemplo serde_json = "1.0.128".

Inicio rápido: primer ejemplo

Creemos una estructura simple y la serializaremos a JSON, y luego la deserializaremos de vuelta:

use serde::{Deserialize, Serialize};\nuse serde_json;\n\n// Estructura con generación automática de código de serialización/deserialización\n#[derive(Serialize, Deserialize, Debug)]\nstruct User {\n    id: u32,\n    name: String,\n    email: String,\n    active: bool,\n}\n\nfn main() {\n    // Creamos una instancia de la estructura\n    let user = User {\n        id: 42,\n        name: "Alicia".to_string(),\n        email: "alice@example.com".to_string(),\n        active: true,\n    };\n\n    // Serialización a cadena JSON\n    let json_string = serde_json::to_string(&user).unwrap();\n    println!("JSON serializado: {}", json_string);\n\n    // Deserialización de vuelta a la estructura\n    let deserialized_user: User = serde_json::from_str(&json_string).unwrap();\n    println!("Estructura deserializada: {:?}", deserialized_user);\n\n    // Verificamos que los datos no se hayan perdido\n    assert_eq!(user.id, deserialized_user.id);\n    assert_eq!(user.name, deserialized_user.name);\n}\n

Salida del programa:

JSON serializado: {"id":42,"name":"Alicia","email":"alice@example.com","active":true}\nEstructura deserializada: User { id: 4