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

FreeLikeTheWind.2023-10-21 18:40

Qt之JSON相关类介绍

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格式

cpp 复制代码 
  {
      "Array": [
          true,
          999,
         string"
      ],
      "Key": "Value",
      "null": null
  }

QJsonDocumentCompact格式

cpp 复制代码 
{"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文档中的对象。
示例
cpp 复制代码 
#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()两个函数来实现相互转换。下面是一个示例：

cpp 复制代码 
#include <QCoreApplication>
#include <QJsonObject>
#include <QVariantMap>
#include <QDebug>

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    // 创建一个QJsonObject
    QJsonObject jsonObject;
    jsonObject["name"] = "John Doe";
    jsonObject["age"] = 25;
    jsonObject["isEmployed"] = true;

    // 将QJsonObject转换为QVariantMap
    QVariantMap variantMap = jsonObject.toVariantMap();

    // 输出转换后的QVariantMap内容
    qDebug() << "QVariantMap:";
    qDebug() << "Name:" << variantMap["name"].toString();
    qDebug() << "Age:" << variantMap["age"].toInt();
    qDebug() << "Is Employed:" << variantMap["isEmployed"].toBool();

    // 创建一个QVariantMap
    QVariantMap newVariantMap;
    newVariantMap["name"] = "Jane Smith";
    newVariantMap["age"] = 30;
    newVariantMap["isEmployed"] = false;

    // 将QVariantMap转换为QJsonObject
    QJsonObject 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：
cpp 复制代码 
QJsonArray jsonArray;
jsonArray.append(10);
jsonArray.append("Hello");
jsonArray.append(false);

QVariantList variantList = jsonArray.toVariantList();

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

将 QVariantList 转换为 QJsonArray：
cpp 复制代码 
QVariantList variantList;
variantList << 10 << "Hello" << false;

QJsonArray jsonArray = QJsonArray::fromVariantList(variantList);

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

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

相关推荐
mmsx10 分钟前
android sqlite 数据库简单封装示例（java）
android·java·数据库
zpjing~.~1 小时前
Mongo 分页判断是否有下一页
数据库
2401_857600951 小时前
技术与教育的融合：构建现代成绩管理系统
数据库·oracle
秋恬意2 小时前
Mybatis能执行一对一、一对多的关联查询吗？都有哪些实现方式，以及它们之间的区别
java·数据库·mybatis
潇湘秦2 小时前
一文了解Oracle数据库如何连接（1）
数据库·oracle
雅冰石2 小时前
oracle怎样使用logmnr恢复误删除的数据
数据库·oracle
web前端神器2 小时前
mongodb给不同的库设置不同的密码进行连接
数据库·mongodb
从以前2 小时前
Berlandesk 注册系统算法实现与解析
数据库·oracle
Muko_0x7d22 小时前
Mongodb
数据库·mongodb
Ren_xixi2 小时前
redis和mysql的区别
数据库·redis·mysql
热门推荐
0119个Web前端交互式3D JavaScript框架和库02优化手机性能，解决卡顿问题：关闭这3个微信开关，释放内存空间03玄机平台应急响应—webshell查杀04RAG 实践- Ollama+RagFlow 部署本地知识库05基于大语言模型（LLM）的合成数据生成、策展和评估的综述06(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明07【一文读懂】NTN（非地面网络）技术介绍08HCIA-datacom数通题库和录播视频资料09Docker 夺命连环 15 问10ZZ038 物联网应用与服务赛题第J套