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
Contiene definiciones comunes tanto a las clases de flujo continuo (QCborStreamReader y QCborStreamWriter) como a QCborValue | |
Se utiliza para contener una matriz de elementos CBOR | |
Se utiliza para contener un contenedor asociativo representable en CBOR | |
Decodificador sencillo de flujos CBOR, que opera tanto con un QByteArray como con un QIODevice | |
Codificador CBOR sencillo que opera sobre un flujo unidireccional | |
Encapsula un valor en CBOR | |
Serialización de datos binarios a un QIODevice | |
Encapsula una matriz JSON | |
Forma de leer y escribir documentos JSON | |
Encapsula un objeto JSON | |
Se utiliza para notificar errores durante el análisis sintáctico de JSON | |
Encapsula un valor en JSON | |
Interfaz práctica para leer y escribir texto | |
Analizador rápido para leer documentos XML 1.0 bien formados a través de una sencilla API de streaming | |
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.