【Qt之JSON文件】QJsonDocument、QJsonObject、QJsonArray等类介绍及使用

QJsonDocument

QJsonDocument类提供了一种读取和写入JSON文档的方式。
QJsonDocument是一个包装完整JSON文档的类，可以从以UTF-8编码的文本表示形式以及Qt自身的二进制格式读取和写入该文档。
可以使用QJsonDocument::fromJson()将基于文本的表示转换为QJsonDocument.toJson()将其转换回文本。解析器非常快速和高效，并将JSON转换为Qt使用的二进制表示形式。
可以使用!isNull()查询已解析文档的有效性。
可以使用isArray()和isObject()查询文档是否包含数组或对象。可以使用array()或object()检索文档中包含的数组或对象，然后进行读取或操作。
还可以使用fromBinaryData()或fromRawData()从存储的二进制表示创建文档。
成员类型文档

常用函数

枚举类型 QJsonDocument::DataValidation

此值用于告诉 QJsonDocument 在使用fromBinaryData()或 fromRawData() 将数据转换为QJsonDocument时是否验证二进制数据。

常量	值	描述
QJsonDocument::Validate	0	在使用数据之前对其进行验证。这是默认值。
QJsonDocument::BypassValidation	1	绕过数据验证。只有当您从可信来源收到数据并知道其有效时才使用，因为使用无效数据可能会导致应用程序崩溃。

枚举类型 QJsonDocument::JsonFormat

此值将数据转换为 QJsonDocument 时生成的 JSON 字节数组的格式。

常量	值	描述
QJsonDocument::Indented	0	定义可读性强的输出，如下所示：
QJsonDocumentCompact	1	定义紧凑的输出，如下所示：

QJsonDocument::Indented格式

  {"Array": [true,999,string"],"Key": "Value","null": null} 

QJsonDocumentCompact格式

{"Array":[true,999,"string"],"Key":"Value","null":null} 

构造函数

• QJsonDocument()：默认构造函数，创建一个空的JSON文档。
• QJsonDocument(const QJsonObject& object)：使用给定的QJsonObject对象创建一个JSON文档。
• QJsonDocument(const QJsonArray& array)：使用给定的QJsonArray对象创建一个JSON文档。

静态函数

• QJsonDocument::fromJson(const QByteArray& json)：将指定的JSON表示形式转换为QJsonDocument对象。
• QJsonDocument::fromVariant(const QVariant& variant)：将给定的QVariant对象转换为QJsonDocument对象。
• QJsonDocument::fromBinaryData(const QByteArray& data, QJsonDocument::DataValidation validation = QJsonDocument::Validate)：从二进制数据创建一个QJsonDocument对象，并可选择是否验证数据。
• QJsonDocument::fromRawData(const char* data, int size, QJsonDocument::DataValidation validation = QJsonDocument::Validate)：从原始二进制数据创建一个QJsonDocument对象，并可选择验证数据。

成员函数

• QJsonDocument::toJson(QJsonDocument::JsonFormat format = QJsonDocument::Indented)`：将QJsonDocument对象转换为JSON表示形式的字节数组。
• QJsonDocument::toVariant()`：将QJsonDocument对象转换为QVariant对象。
• QJsonDocument::isEmpty()`：检查JSON文档是否为空。
• QJsonDocument::isNull()`：检查JSON文档是否为null。
• QJsonDocument::isArray()：检查JSON文档是否为数组。
• QJsonDocument::isObject()：检查JSON文档是否为对象。
• QJsonDocument::array()：获取JSON文档中的数组。
• QJsonDocument::object()：获取JSON文档中的对象。

示例

#include <QCoreApplication>
#include <QJsonDocument>
#include <QJsonObject>
#include <QJsonArray>
#include <QDebug>int main(int argc, char *argv[])
{QCoreApplication a(argc, argv);// 创建一个JSON文档QJsonObject object;object["name"] = "John Doe";object["age"] = 25;QJsonArray hobbies;hobbies.append("reading");hobbies.append("music");object["hobbies"] = hobbies;QJsonDocument doc(object);// 将JSON文档转换为字符串表示形式QByteArray jsonBytes = doc.toJson(QJsonDocument::Indented);QString jsonString = QString::fromUtf8(jsonBytes);qDebug() << "JSON Document:" << jsonString;// 解析JSON文档QJsonDocument parsedDoc = QJsonDocument::fromJson(jsonBytes);if(parsedDoc.isNull()){qDebug() << "Failed to parse JSON document.";return 0;}// 检查JSON文档是否为对象if(parsedDoc.isObject()){QJsonObject parsedObject = parsedDoc.object();qDebug() << "Parsed JSON Object:";qDebug() << "Name:" << parsedObject["name"].toString();qDebug() << "Age:" << parsedObject["age"].toInt();qDebug() << "Hobbies:";QJsonArray parsedHobbies = parsedObject["hobbies"].toArray();for(const auto& hobby : parsedHobbies){qDebug() << "  -" << hobby.toString();}} else {qDebug() << "Parsed JSON document is not an object.";return 1;}return a.exec();
}

在示例中，创建了一个JSON文档，其中含了一个包含姓名年龄和兴趣爱好的对象。
然后，将该对象转换为JSON字符串表示形式，并输出到控制台。
接下来，使用QJsonDocument::fromJson()函数解析该JSON字符串，将其转换为QJsonDocument对象。
最后，检查解析的JSON文档是否为对象，并打印出对象中的值。

示例展示了使用QJsonDocument类创建和解析JSON文档。可以根据需求修改和扩展代码。请注意，示例中使用了Qt应用程序和处理事件循环。如果在不使用Qt框架的环境中使用QJsonDocument，需要相应地修改代码。

QJsonObject

QJsonObject 类封装了一个JSON对象。JSON 对象是一个键值对列表，其中键是唯一的字符串，值由QJsonValue表示。QJsonObject 可以与 QVariantMap 相互转换。您可以使用size()查询（键，值）对的数量，使用insert()和remove()从中插入和删除条目，并使用标准的 C++ 迭代器模式遍历其内容。QJsonObject 是一个隐式共享类，只要不进行修改，它就会与创建它的文档共享数据。您可以通过QJsonDocument将对象从基于文本的 JSON 转换出来和转换进去。

常用函数

构造函数：

• QJsonObject()：默认构造函数，创建一个空的JSON对象。
• QJsonObject(const QJsonObject &other)：拷贝构造函数，根据另一个JSON对象创建一个新的JSON对象。

成员函数：

• bool isEmpty() const：判断JSON对象是否为空，如果对象中不包含任何属性，则返回true，否则返回false。
• int size() const：返回JSON对象中属性的数量。
• bool contains(const QString &key) const：检查JSON对象中是否包含指定键。
• void insert(const QString &key, const QJsonValue &value)：向JSON对象中插入一个键值对。
• void remove(const QString &key)：从JSON对象中移除指定键的属性。
• QJsonValue value(const QString &key) const：返回指定键对应的值。如果键不存在，则返回QJsonValue()。
• QStringList keys() const：返回JSON对象中所有键的列表。
• QJsonObject &operator=(const Q &other)：赋值运算符，将另一个JSON对象属性复制到当前对象中。
• QJsonValue operator[](const QString &key) const：通过键访问JSON对象的属性值。

通过这些构造函数和成员函数，可以创建JSON对象、添加、移除和访问对象的属性值，并操作以及获取对象的相关信息。这些函数提供了便捷的方式来处理和操作JSON对象。

QJsonObject 与 QVariantMap 相互转换

在C++中，可以使用QJsonObject和QVariantMap之间的fromVariant()和toVariant()两个函数来实现相互转换。下面是一个示例：

#include <QCoreApplication>
#include <QJsonObject>
#include <QVariantMap>
#include <QDebug>int main(int argc, char *argv[])
{QCoreApplication a(argc, argv);// 创建一个QJsonObjectQJsonObject jsonObject;jsonObject["name"] = "John Doe";jsonObject["age"] = 25;jsonObject["isEmployed"] = true;// 将QJsonObject转换为QVariantMapQVariantMap variantMap = jsonObject.toVariantMap();// 输出转换后的QVariantMap内容qDebug() << "QVariantMap:";qDebug() << "Name:" << variantMap["name"].toString();qDebug() << "Age:" << variantMap["age"].toInt();qDebug() << "Is Employed:" << variantMap["isEmployed"].toBool();// 创建一个QVariantMapQVariantMap newVariantMap;newVariantMap["name"] = "Jane Smith";newVariantMap["age"] = 30;newVariantMap["isEmployed"] = false;// 将QVariantMap转换为QJsonObjectQJsonObject newJsonObject = QJsonObject::fromVariantMap(newVariantMap);// 输出转换后的QJsonObject内容qDebug() << "QJsonObject:";qDebug() << "Name:" << newJsonObject["name"].toString();qDebug() << "Age:" << newJsonObject["age"].toInt();qDebug() << "Is Employed:" << newJsonObject["isEmployed"].toBool();return a.exec();
}

在上述示例中，创建了一个QJsonObject对象jsonObject，并为其添加了一些键值对。
然后，使用toVariantMap()函数将其转换为QVariantMap对象variantMap，并输出其内容。
接下来，创建了一个新的QVariantMap对象newVariantMap，并为其添加了一些键值对。
最后，使用QJsonObject的fromVariantMap()函数将newVariantMap转换回QJsonObject对象newJsonObject，并输出其内容。

通过toVariantMap()和fromVariantMap()函数，可以方便地在QJsonObject和QVariantMap之间进行转换，并且可以在转换后访问和操作数据。这些函数是互相转换的，可以根据需要在QJsonObject和QVariantMap之间进行双向转

QJsonArray

QJsonArray类封装了一个JSON数组。
QJsonArray可以与QVariantList相互转换。可以使用size()、insert()和removeAt()来查询数组中的条目数量，并使用标准的C++迭代器模式遍历其内容。
QJsonArray是一个隐式共享的类，并且只要它没有被修改，就与其创建的文档共享数据。
可以通过QJsonDocument将数组转换为基于文本的JSON，也可以将文本转换为数组。

常用函数

QJsonArray是Qt框架中的一个类，用于表示JSON数组。它提供了一组构造函数和一些常用的成员函数，用于创建、操作和访问JSON数组的元素。下面是QJsonArray的构造函数和一些常用成员函数介绍：

构造函数：

• QJsonArray()：默认构造函数，创建一个空的JSON数组
• QJsonArray(const QJsonArray &other)：拷贝构造函数，根据另一个JSON数组创建一个新的JSON数组。
• QJsonArray(std::initializer_list<QJsonValue> list)：使用初始化列表创建一个新的JSON数组。

成员函数：

• bool isEmpty() const：判断JSON数组是否为空，如果数组中不包含任何元素，则返回true，否则返回``。
• int size() const：返回JSON数组中元素的数量。
• void append(const QJsonValue &value)：向JSON数组末尾添加一个元素。
• void prepend(const QJsonValue &value)：在JSON数组开头插入一个元素。
• void insert(int index, const QJsonValue &value)：在指定位置插入一个元素。
• void removeAt(int index)：移除指定位置的元素。
• QJsonValue at(int index) const：返回指定位置的元素。
• QJsonValue operator[](int index) const：通过索引访问JSON数组的元素。
• void replace(int index, const QJsonValue &value)：替换指定位置的元素。
• QVariantList toVariantList() const：将JSON数组转换为QVariantList。
• QString toJson(QDocument::JsonFormat format = QJsonDocument::Indented) const：将JSON数组转换为文本形式的JSON。

通过这些构造函数和成员函数，可以创建JSON数组、添加、移除和访数组的元素，并操作以及获取数组的相关信息。

QJsonArray与QVariantList相互转换

以下是将 QJsonArray 转换为 QVariantList 和将 QVariantList 转换为 QJsonArray 相互转换示例。

将 QJsonArray 转换为 QVariantList：

QJsonArray jsonArray;
jsonArray.append(10);
jsonArray.append("Hello");
jsonArray.append(false);QVariantList variantList = jsonArray.toVariantList();

在示例中，创建一个 QJsonArray 对象 jsonArray，然后向其中添加一些元素。使用 jsonArray 的 toVariantList() 函数将其转换为 QVariantList 对象 variantList。

将 QVariantList 转换为 QJsonArray：

QVariantList variantList;
variantList << 10 << "Hello" << false;QJsonArray jsonArray = QJsonArray::fromVariantList(variantList);

在示例中，创建一个 QVariantList 对象 variantList，并向其中添加一些元素。然后，使用 QJsonArray 的静态函数 fromVariantList() 将 variantList 转换为 QJsonArray 对象 jsonArray。

通过这些示例，可以在 QJsonArray 和 QVariantList 之间进行双向转换，方便地在 JSON 数据和 QVariant 数据之间进行处理和传递。