qt5怎么解析json数组

Qt5 中解析 JSON 数组的完整指南

在 Qt5 开发中，处理 JSON 数据是一项常见任务，JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，易于人阅读和编写，同时也易于机器解析和生成，本文将详细介绍如何在 Qt5 中解析 JSON 数组，包括从基础概念到实际应用的完整流程。

Qt5 中 JSON 处理的基础

Qt5 提供了 QJsonDocument、QJsonObject、QJsonArray 等类来处理 JSON 数据，这些类位于 QtJson 模块中，使用前需要确保在项目文件（.pro）中添加：

QT += core json

解析 JSON 数组的步骤

准备 JSON 数据

假设我们有以下 JSON 数组数据：

[
    {"id": 1, "name": "Alice", "age": 25},
    {"id": 2, "name": "Bob", "age": 30},
    {"id": 3, "name": "Charlie", "age": 35}
]

将 JSON 字符串转换为 QJsonDocument

我们需要将 JSON 字符串解析为 QJsonDocument 对象：

#include <QJsonDocument>
#include <QJsonArray>
#include <QJsonObject>
#include <QDebug>
void parseJsonArray(const QString &jsonString) {
    // 将 JSON 字符串转换为 QJsonDocument
    QJsonDocument doc = QJsonDocument::fromJson(jsonString.toUtf8());
    // 检查 JSON 是否有效且为数组
    if (doc.isNull() || !doc.isArray()) {
        qDebug() << "Invalid JSON or not an array";
        return;
    }
    // 获取 JSON 数组
    QJsonArray jsonArray = doc.array();
}

遍历 JSON 数组

我们遍历 JSON 数组中的每个元素：

    // 遍历 JSON 数组
    for (int i = 0; i < jsonArray.size(); ++i) {
        QJsonValue value = jsonArray.at(i);
        // 检查元素是否为对象
        if (!value.isObject()) {
            qDebug() << "Element at index" << i << "is not an object";
            continue;
        }
        QJsonObject obj = value.toObject();
        // 处理每个对象...
    }

提取对象中的值

在遍历数组时,我们可以从每个对象中提取所需的值：

        // 提取值并转换为相应的 Qt 类型
        int id = obj.value("id").toInt();
        QString name = obj.value("name").toString();
        int age = obj.value("age").toInt();
        // 打印提取的值
        qDebug() << "Person" << i << ":"
                 << "ID:" << id
                 << "Name:" << name
                 << "Age:" << age;

完整示例代码

将以上步骤整合,完整的解析函数如下：

void parseJsonArray(const QString &jsonString) {
    // 将 JSON 字符串转换为 QJsonDocument
    QJsonDocument doc = QJsonDocument::fromJson(jsonString.toUtf8());
    // 检查 JSON 是否有效且为数组
    if (doc.isNull() || !doc.isArray()) {
        qDebug() << "Invalid JSON or not an array";
        return;
    }
    // 获取 JSON 数组
    QJsonArray jsonArray = doc.array();
    qDebug() << "JSON array size:" << jsonArray.size();
    // 遍历 JSON 数组
    for (int i = 0; i < jsonArray.size(); ++i) {
        QJsonValue value = jsonArray.at(i);
        // 检查元素是否为对象
        if (!value.isObject()) {
            qDebug() << "Element at index" << i << "is not an object";
            continue;
        }
        QJsonObject obj = value.toObject();
        // 提取值并转换为相应的 Qt 类型
        int id = obj.value("id").toInt();
        QString name = obj.value("name").toString();
        int age = obj.value("age").toInt();
        // 打印提取的值
        qDebug() << "Person" << i << ":"
                 << "ID:" << id
                 << "Name:" << name
                 << "Age:" << age;
    }
}

处理复杂数据结构

JSON 数组中的元素可能不仅仅是简单的键值对，还可能包含嵌套的对象或数组。

[
    {
        "id": 1,
        "name": "Alice",
        "hobbies": ["reading", "swimming", "coding"]
    },
    {
        "id": 2,
        "name": "Bob",
        "address": {
            "street": "123 Main St",
            "city": "New York"
        }
    }
]

处理这种复杂数据时,需要递归地检查和解析嵌套的结构：

void parseComplexJsonArray(const QString &jsonString) {
    QJsonDocument doc = QJsonDocument::fromJson(jsonString.toUtf8());
    if (doc.isNull() || !doc.isArray()) {
        qDebug() << "Invalid JSON or not an array";
        return;
    }
    QJsonArray jsonArray = doc.array();
    for (int i = 0; i < jsonArray.size(); ++i) {
        QJsonValue value = jsonArray.at(i);
        if (!value.isObject()) {
            qDebug() << "Element at index" << i << "is not an object";
            continue;
        }
        QJsonObject obj = value.toObject();
        int id = obj.value("id").toInt();
        QString name = obj.value("name").toString();
        qDebug() << "Person" << i << ": ID:" << id << "Name:" << name;
        // 处理 hobbies 数组
        if (obj.contains("hobbies") && obj.value("hobbies").isArray()) {
            QJsonArray hobbiesArray = obj.value("hobbies").toArray();
            qDebug() << "Hobbies:";
            for (int j = 0; j < hobbiesArray.size(); ++j) {
                qDebug() << " -" << hobbiesArray.at(j).toString();
            }
        }
        // 处理嵌套的 address 对象
        if (obj.contains("address") && obj.value("address").isObject()) {
            QJsonObject addressObj = obj.value("address").toObject();
            QString street = addressObj.value("street").toString();
            QString city = addressObj.value("city").toString();
            qDebug() << "Address:" << street << "," << city;
        }
    }
}

错误处理

在实际应用中,JSON 数据可能不符合预期，因此添加适当的错误处理非常重要：

void parseJsonArrayWithErrors(const QString &jsonString) {
    // 检查字符串是否为空
    if (jsonString.isEmpty()) {
        qDebug() << "JSON string is empty";
        return;
    }
    // 解析 JSON
    QJsonDocument doc = QJsonDocument::fromJson(jsonString.toUtf8());
    // 检查解析是否成功
    if (doc.isNull()) {
        qDebug() << "Failed to parse JSON";
        return;
    }
    // 检查是否为数组
    if (!doc.isArray()) {
        qDebug() << "JSON is not an array";
        return;
    }
    // 检查数组是否为空
    QJsonArray jsonArray = doc.array();
    if (jsonArray.isEmpty()) {
        qDebug() << "JSON array is empty";
        return;
    }
    // 遍历数组...
}

从文件读取 JSON 数组

在实际应用中,JSON 数据通常存储在文件中，以下是如何从文件读取并解析 JSON 数组的示例：

void parseJsonArrayFromFile(const QString &filePath) {
    QFile file(filePath);
    if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) {
        qDebug() << "Could not open file:" << filePath;
        return;
    }
    QByteArray jsonData = file.readAll();
    file.close();
    parseJsonArray(QString::fromUtf8(jsonData));
}

在 Qt5 中解析 JSON 数组主要涉及以下几个步骤：