En esta página

Serialización en Qt

El objetivo de la serialización es guardar el estado de un objeto para poder recrearlo cuando sea necesario. Te permite realizar acciones como:

  • Enviar el objeto a una aplicación remota mediante un servicio web
  • Pasar el objeto como una cadena JSON o XML
  • Guardar y restaurar información del usuario o compartirla entre aplicaciones

La API de Qt ofrece soporte para la serialización en varios casos de uso:

  • La compatibilidadcon JSON en Qt ofrece una API de C++ fácil de usar para analizar, modificar y guardar datos JSON. La compatibilidad con CBOR en Qt es un formato compacto de codificación de datos binarios que constituye un superconjunto de JSON.
  • QDataStream Ofrece la serialización de datos binarios a un QIODevice
  • Qt XML C++ Classes proporciona implementaciones en C++ de los estándares XML Streaming y DOM para XML
  • CBOR es la implementación de Qt para el formato de serialización CBOR.
  • QSettings Ofrece una forma de serializar y almacenar la configuración de las aplicaciones de forma independiente de la plataforma.

Ventajas de JSON y CBOR

Cuando se utiliza JSON, la información se almacena en un « QJsonObject » y un « QJsonDocument » se encarga de transmitir los valores a un « QByteArray ».

Por ejemplo

QJsonObject jobject;
jobject["SensorID"] = m_id;
jobject["AmbientTemperature"] = m_ambientTemperature;
jobject["ObjectTemperature"] = m_objectTemperature;
jobject["AccelerometerX"] = m_accelerometerX;
jobject["AccelerometerY"] = m_accelerometerY;
jobject["AccelerometerZ"] = m_accelerometerZ;
jobject["Altitude"] = m_altitude;
jobject["Light"] = m_light;
jobject["Humidity"] = m_humidity;
QJsonDocument doc( jobject );

return doc.toJson();

JSON presenta varias ventajas:

  • El JSON textual es declarativo, lo que lo hace legible para las personas
  • La información está estructurada
  • El intercambio de información genérica es sencillo
  • JSON permite ampliar los mensajes con valores adicionales
  • Existen numerosas soluciones para recibir y analizar JSON en entornos basados en la nube

CBOR son las siglas de «Concise Binary Object Representation» (Representación concisa de objetos binarios), un formato muy compacto de codificación de datos binarios que constituye un superconjunto de JSON. Fue creado por el grupo de trabajo «Constrained RESTful Environments» (CoRE) de la IETF, y se ha utilizado en muchos nuevos RFC. CBOR comparte muchas de las ventajas de JSON, pero sacrifica la legibilidad para el ser humano en aras de la compacidad.

Ventajas de las clases QDataStream

QDataStream Es una opción viable cuando se conoce todo el flujo de datos y no está previsto que cambie. Además, tanto el lector como el escritor de los datos deben estar escritos en Qt.

Añadir compatibilidad con esto a una clase requiere dos operadores adicionales. Por ejemplo, para una clase llamada SensorInformation:

QDataStream &operator<<(QDataStream &, const SensorInformation &);
QDataStream &operator>>(QDataStream &, SensorInformation &);

A continuación se muestra la implementación de la serialización:

QDataStream &operator<<(QDataStream &out, const SensorInformation &item)
{
    QDataStream::FloatingPointPrecision prev = out.floatingPointPrecision();
    out.setFloatingPointPrecision(QDataStream::DoublePrecision);
    out << item.m_id
        << item.m_ambientTemperature
        << item.m_objectTemperature
        << item.m_accelerometerX
        << item.m_accelerometerY
        << item.m_accelerometerZ
        << item.m_altitude
        << item.m_light
        << item.m_humidity;
    out.setFloatingPointPrecision(prev);
    return out;
}

La deserialización funciona de manera similar, pero utilizando el operador ` >> `. Por ejemplo, ` out >> item.m_id`, y así sucesivamente.

Por lo general, el uso de « QDataStream » es más rápido que el uso de JSON textual.

Ventajas de las clases de C++ de « Qt XML »

Qt proporciona tanto clases DOM como clases basadas en flujos para leer y escribir contenido XML.

Qt proporciona la clase ` QDomDocument `, que representa el documento XML, y dos clases para leer y escribir el XML a través de una sencilla API de flujos: ` QXmlStreamReader ` y ` QXmlStreamWriter`.

Las clases DOM XML

QDomDocument representa el documento XML completo. Es la raíz del árbol del documento y proporciona el acceso principal a los datos del documento.

Las clases XML basadas en flujos

Un lector de flujo presenta un documento XML como un flujo de tokens. Esto difiere de SAX, ya que las aplicaciones SAX proporcionan controladores para recibir eventos XML del analizador, mientras que el ` QXmlStreamReader ` controla el bucle, extrayendo tokens del lector cuando son necesarios. Este enfoque de extracción permite crear analizadores recursivos descendentes, lo que permite dividir el código de análisis XML en diferentes métodos o clases.

QXmlStreamReader un analizador para XML 1.0 bien formado, excluyendo las entidades analizadas externas. Por lo tanto, los datos proporcionados al lector de flujos deben cumplir los criterios del W3C para un XML bien formado; de lo contrario, se generará un error. Se pueden utilizar funciones como atEnd(), error() y hasError() para detectar dichos errores y obtener una descripción de los mismos.

La función QXmlStreamWriter es una API de flujo que se encarga de añadir el prefijo a los espacios de nombres cuando se especifica el namespaceUri al escribir elementos o atributos.

Clases que proporcionan serialización

<QtCborCommon>

Contiene definiciones comunes tanto a las clases de flujo continuo (QCborStreamReader y QCborStreamWriter) como a QCborValue

QCborArray

Se utiliza para contener una matriz de elementos CBOR

QCborMap

Se utiliza para contener un contenedor asociativo representable en CBOR

QCborStreamReader

Decodificador sencillo de flujos CBOR, que opera tanto con un QByteArray como con un QIODevice

QCborStreamWriter

Codificador CBOR sencillo que opera sobre un flujo unidireccional

QCborValue

Encapsula un valor en CBOR

QDataStream

Serialización de datos binarios a un QIODevice

QJsonArray

Encapsula una matriz JSON

QJsonDocument

Forma de leer y escribir documentos JSON

QJsonObject

Encapsula un objeto JSON

QJsonParseError

Se utiliza para notificar errores durante el análisis sintáctico de JSON

QJsonValue

Encapsula un valor en JSON

QTextStream

Interfaz práctica para leer y escribir texto

QXmlStreamReader

Analizador rápido para leer documentos XML 1.0 bien formados a través de una sencilla API de streaming

QXmlStreamWriter

Generador de XML 1.0 con una sencilla API de streaming

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.