Saltar al contenido principal
riqo.ioHerramientas para grandes ideas

Serialización y deserialización de datos

Cómo las estructuras en memoria se convierten en representaciones transferibles y qué problemas aparecen entre tipos, versiones y sistemas.

Concepto y contexto

Serializar transforma estado o estructuras de datos en una representación transferible o persistente; deserializar reconstruye datos desde esa representación.

El problema central es el contrato de datos, no solo elegir JSON, XML o un formato binario.

Un buen modelo mental separa el concepto abstracto de su representación concreta y del entorno donde se utiliza. Esa separación evita trasladar automáticamente supuestos válidos en un protocolo, biblioteca o formato hacia sistemas que pueden aplicar reglas o garantías diferentes.

Fundamentos y terminología

Esquemas, tipos, encoding, orden y precisión numérica determinan cuánta información sobrevive al round trip.

Los lenguajes suelen tener tipos más ricos que los formatos de intercambio, por lo que fechas, decimales o claves no textuales necesitan convenciones explícitas.

La terminología debe leerse junto con el estándar, versión o contrato que la define, porque palabras parecidas pueden describir propiedades distintas según la capa. Explicitar esas definiciones mejora interoperabilidad, documentación y capacidad para diagnosticar comportamientos inesperados.

Cómo funciona

Un serializer recorre los datos, aplica reglas de mapeo y produce texto o bytes según el formato.

El deserializer debe validar la entrada, reconstruir tipos y gestionar campos ausentes o desconocidos sin asumir que el origen es confiable.

En sistemas reales conviene seguir el recorrido de los datos entre capas e identificar qué transformaciones son reversibles, cuáles introducen restricciones y dónde puede perderse información. Así resulta más sencillo razonar sobre responsabilidades entre productores, consumidores, almacenamiento y transporte.

Ejemplo razonado

Un timestamp con zona puede serializarse como ISO 8601 y reconstruirse como instante con offset.

Si se reduce a una fecha local sin offset se pierde significado y distintos sistemas pueden obtener instantes diferentes.

Un ejemplo razonado es reutilizable cuando muestra sus precondiciones e invariantes y no solo el resultado final. Cambiar un supuesto cada vez permite distinguir el comportamiento garantizado por un estándar de las decisiones particulares de una aplicación o implementación.

Errores y conceptos equivocados

Deserializar objetos arbitrarios no es solo parsing: algunos formatos o frameworks pueden instanciar tipos o activar comportamientos inseguros.

Persistir representaciones nativas de un lenguaje también acopla datos a detalles de implementación y versiones.

Muchos fallos nacen de supuestos implícitos entre sistemas aparentemente compatibles que usan versiones, reglas de canonicalización o modelos de tipos diferentes. En interoperabilidad y seguridad conviene especificar y probar entradas anómalas en lugar de tratarlas como casos irrelevantes.

Buenas prácticas y criterios de elección

Define contratos explícitos, limita tipos aceptados, valida antes de usar y planifica la evolución del esquema.

Prefiere representaciones interoperables a volcados de memoria y separa los trade-offs de compatibilidad, tamaño, velocidad y depuración.

Una práctica robusta combina estándares documentados, bibliotecas maduras, contratos explícitos y pruebas con casos límite representativos. La mejor elección no es siempre la más breve o popular: también cuentan portabilidad, legibilidad, rendimiento, seguridad, evolución y coste operativo.

Guías relacionadas

JSON Schema: describir y validar estructuras de datos

Cómo JSON Schema expresa tipos, propiedades, restricciones, composición y compatibilidad de documentos JSON.

JSON vs YAML vs XML: qué formato elegir

Comparación razonada de JSON, YAML y XML para API, configuración, documentos, esquemas e interoperabilidad.

YAML: sintaxis, tipos y estructuras

Una guía de YAML como formato de serialización legible: escalares, colecciones, indentación, anchors y problemas de parsing.

XML: elementos, atributos, namespaces y documentos

Fundamentos de XML: estructura de árbol, atributos, namespaces, encoding, validación e interoperabilidad.