qt怎么添加json

Qt中轻松处理JSON：多种方法添加与使用JSON支持**

在现代软件开发中，JSON（JavaScript Object Notation）因其轻量级、易读易写的特性，成为数据交换的主流格式之一，Qt框架作为一款强大的跨平台C++库，对JSON提供了良好的支持，本文将详细介绍在Qt中如何添加和使用JSON功能,主要涵盖Qt内置的JSON模块以及第三方库QJson的使用。

使用Qt内置的JSON模块（推荐）

Qt 5.0及以上版本开始，将JSON支持整合到了核心模块中，无需额外安装，只需在项目中正确引入即可，这包括QJsonDocument、QJsonObject、QJsonArray、QJsonValue等核心类。

添加必要的文件包含

在你的C++源文件（通常是.cpp或.h文件）中,包含以下头文件：

#include <QJsonDocument>
#include <QJsonObject>
#include <QJsonArray>
#include <QJsonValue>
#include <QJsonParseError>
#include <QDebug>

JSON数据的生成（序列化）

将Qt的数据结构转换为JSON字符串,这个过程称为序列化。

示例：创建JSON对象并转换为字符串

#include <QCoreApplication>
#include <QJsonDocument>
#include <QJsonObject>
#include <QJsonArray>
#include <QDebug>
int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);
    // 1. 创建 QJsonObject
    QJsonObject personObject;
    personObject["name"] = "张三";
    personObject["age"] = QJsonValue(30); // 也可以直接写 30，Qt会自动转换
    personObject["isStudent"] = false;
    // 2. 创建嵌套的 QJsonObject
    QJsonObject addressObject;
    addressObject["city"] = "北京";
    addressObject["street"] = "中关村大街1号";
    personObject["address"] = addressObject;
    // 3. 创建 QJsonArray 并添加到对象
    QJsonObject hobbiesArray;
    QJsonArray hobbies;
    hobbies.append("编程");
    hobbies.append("阅读");
    hobbies.append("旅游");
    personObject["hobbies"] = hobbies;
    // 4. 将 QJsonObject 转换为 QJsonDocument
    QJsonDocument doc(personObject);
    // 如果JSON对象是顶层对象，使用 QJsonDocument::JsonObject
    // 如果是JSON数组，使用 QJsonDocument::JsonArray
    // 5. 将 QJsonDocument 转换为 JSON 字符串
    // 选项：QJsonDocument::Compact (无缩进) 或 QJsonDocument::Indented (有缩进，易读)
    QByteArray jsonString = doc.toJson(QJsonDocument::Indented);
    qDebug() << "生成的JSON字符串：";
    qDebug().noquote() << jsonString; // noquote() 避免字符串被额外引号包围
    return a.exec();
}

JSON数据的解析（反序列化）

将JSON字符串解析为Qt的数据结构,这个过程称为反序列化。

示例：解析JSON字符串

#include <QCoreApplication>
#include <QJsonDocument>
#include <QJsonObject>
#include <QJsonArray>
#include <QJsonValue>
#include <QJsonParseError>
#include <QDebug>
int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);
    QString jsonString = R"(
    {
        "name": "李四",
        "age": 25,
        "isStudent": true,
        "address": {
            "city": "上海",
            "street": "南京路100号"
        },
        "hobbies": ["音乐", "电影", "运动"]
    }
    )";
    // 1. 将字符串转换为 QJsonDocument
    QJsonDocument doc = QJsonDocument::fromJson(jsonString.toUtf8());
    if (doc.isNull()) {
        QJsonParseError parseError;
        doc = QJsonDocument::fromJson(jsonString.toUtf8(), &parseError);
        qDebug() << "解析JSON失败:" << parseError.errorString();
        return -1;
    }
    // 2. 检查是对象还是数组
    if (doc.isObject()) {
        QJsonObject jsonObject = doc.object();
        qDebug() << "姓名:" << jsonObject["name"].toString();
        qDebug() << "年龄:" << jsonObject["age"].toInt();
        qDebug() << "是否学生:" << jsonObject["isStudent"].toBool();
        // 解析嵌套对象
        if (jsonObject.contains("address") && jsonObject["address"].isObject()) {
            QJsonObject addressObj = jsonObject["address"].toObject();
            qDebug() << "城市:" << addressObj["city"].toString();
            qDebug() << "街道:" << addressObj["street"].toString();
        }
        // 解析数组
        if (jsonObject.contains("hobbies") && jsonObject["hobbies"].isArray()) {
            QJsonArray hobbiesArray = jsonObject["hobbies"].toArray();
            qDebug() << "爱好:";
            for (int i = 0; i < hobbiesArray.size(); ++i) {
                qDebug() << "  -" << hobbiesArray.at(i).toString();
            }
        }
    } else if (doc.isArray()) {
        QJsonArray jsonArray = doc.array();
        qDebug() << "这是一个JSON数组，包含" << jsonArray.size() << "个元素";
        // ... 处理数组
    }
    return a.exec();
}

使用第三方库QJson（旧版Qt或特定需求）

虽然Qt内置JSON模块已经很强大，但在一些非常旧的Qt版本（如Qt 4）中，或者开发者习惯于QJson的API时，可能会选择使用第三方QJson库，QJson是一个纯C++实现的库,不依赖于Qt的信号槽机制。

获取QJson

QJson托管在GitHub上：https://github.com/flavio/qjson （注意：该项目可能已不再积极维护,新项目推荐使用Qt内置JSON）

集成QJson到Qt项目

通常需要下载源代码，然后将其添加到你的Qt项目中，可以通过qmake的INCLUDEPATH和LIBS，或者CMake的include_directories和target_link_libraries来集成。

以qmake为例，在你的.pro文件中添加：

# 假设QJson源码放在项目目录下的qjson子目录
INCLUDEPATH += $$PWD/qjson/include
LIBS += -L$$PWD/qjson/lib -lqjson

（具体路径和库名称可能根据你的下载和编译情况有所不同）

使用QJson API示例

QJson的核心类包括QJsonDocument、QJsonObject、QJsonArray、QJsonValue等，命名空间为QJson。

生成JSON：

#include <QCoreApplication>
#include <QJsonDocument>
#include <QJsonObject>
#include <QJsonArray>
#include <QDebug>
#include <QJson/Parser> // 注意：QJson的Parser和Serializer
#include <QJson/Serializer>
int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);
    QJsonObject personObject;
    personObject["name"] = "王五";
    personObject["age"] = 28;
    QJsonArray hobbies;
    hobbies << "游戏" << "美食";
    personObject["hobbies"] = hobbies;
    QJson::Serializer serializer;
    bool ok;
    QByteArray json = serializer.serialize(personObject, &ok); // 注意：API与Qt内置不同
    if (ok) {
        qDebug() << "QJson生成的字符串：";
        qDebug().noquote() << json;
    } else {
        qDebug() << "序列化失败:" << serializer.errorString();
    }
    return a.exec();
}

解析JSON：

#include <QCoreApplication>
#include <QJsonDocument>
#include <QJsonObject>
#include <QJsonArray>
#include <QDebug>
#include <QJson/Parser> // 注意：QJson的Parser和Serializer
int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);
    QString jsonString = "{\"name\":\"赵六\",\"age\":32,\"hobbies\":[\"绘画\",\"摄影\"]}";
    QJson::Parser parser;
    bool ok;
    QVariant result = parser.parse(jsonString.toUtf8(), &ok); // QJson解析为QVariant
    if (ok) {
        if (result.type() == QVariant::Map) { // JSON对象解析为QMap的QVariant
            QVariantMap map = result.toMap();
            qDebug() << "姓名:" << map["name"].toString();
            qDebug() << "年龄:" << map["age"].toInt();
            if (map.contains("hobbies") && map["hobbies"].type() == QVariant::List) {
                QVariantList hobbiesList = map["hobbies"].toList();
                qDebug() << "爱好:";
                foreach (const QVariant &hobby, hobbiesList) {
                    qDebug() << "  -" << hobby.toString();
                }
            }
        }
    } else {
        qDebug() << "QJson解析失败:" << parser.errorString();
    }
    return a.exec();