桌面应用 / 系统课时

解析 JSON 对象和数组

解析 JSON 对象和数组

本篇学习如何在 Qt 6 中解析网络接口返回的 JSON 数据。通过 QJsonDocument、QJsonObject 和 QJsonArray,可以将文本格式的响应转换为可访问的数据结构,并安全读取对象字段和数组元素。

学习目标

  • 理解 Qt JSON 类之间的关系和解析流程
  • 掌握使用 QJsonDocument 解析对象与数组数据
  • 能够处理接口返回中的字段读取和类型转换

使用 Qt JSON 类处理接口响应

网络接口通常返回 JSON 文本,例如用户信息、商品列表或配置数据。Qt 不直接通过字符串操作 JSON,而是提供了一组专用类处理结构化数据。

常用类型之间的关系如下:

类型 作用
QJsonDocument JSON 文档入口,负责文本与 JSON 结构转换
QJsonObject 表示 JSON 对象,访问键值对
QJsonArray 表示 JSON 数组,访问有序元素
QJsonValue 表示单个 JSON 值

解析流程通常是先使用 QJsonDocument::fromJson() 将响应文本转换为文档,再根据根节点类型获取对象或数组。

解析 JSON 对象数据

接口返回对象时,最外层通常使用花括号,例如:

json
{
  "id": 1001,
  "name": "Qt User",
  "active": true
}

可以通过 QJsonObject 按字段名称读取数据。

cpp
#include <QCoreApplication>
#include <QJsonDocument>
#include <QJsonObject>
#include <QDebug>

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

    QByteArray jsonData = R"({"id":1001,"name":"Qt User","active":true})";

    QJsonDocument document = QJsonDocument::fromJson(jsonData);
    QJsonObject object = document.object();

    int id = object.value("id").toInt();
    QString name = object.value("name").toString();
    bool active = object.value("active").toBool();

    qDebug() << id << name << active;

    return 0;
}

预期输出

text
1001 "Qt User" true

读取字段时,应根据实际 JSON 类型调用对应转换方法,例如数字使用 toInt(),字符串使用 toString()。如果字段不存在,QJsonValue 会返回空值,需要根据业务决定是否使用默认值。

解析 JSON 数组数据

接口返回列表数据时,根节点通常是数组,例如:

json
[
  {"id":1,"name":"A"},
  {"id":2,"name":"B"}
]

此时需要先通过 QJsonDocument 获取 QJsonArray,再遍历每个元素。

cpp
QJsonArray array = document.array();

for (const QJsonValue &value : array) {
    QJsonObject item = value.toObject();
    qDebug() << item.value("id").toInt()
             << item.value("name").toString();
}

预期输出

text
1 "A"
2 "B"

数组中的元素类型可能不同,实际开发中应先判断 QJsonValue 的类型,再进行转换,避免因为格式变化导致读取异常。

处理嵌套 JSON 结构

真实接口经常同时包含对象和数组,例如用户对象中包含订单列表:

json
{
  "user":"Tom",
  "orders":[
    {"id":1},
    {"id":2}
  ]
}

解析时需要逐层进入对应结构:先获取对象,再读取数组字段,最后处理数组元素。

在 Qt 项目中,JSON 解析代码通常放在网络请求完成回调中。解析前应检查 JSON 文档是否有效,例如判断 fromJson() 返回的错误信息,避免接口返回 HTML 或错误文本时产生误判。

选择对象还是数组的判断方式

当接口格式不固定时,可以先判断文档根节点类型:

cpp
if (document.isObject()) {
    QJsonObject object = document.object();
    qDebug() << "object response";
} else if (document.isArray()) {
    QJsonArray array = document.array();
    qDebug() << "array response";
}

预期结果

text
根据接口返回格式输出 object response 或 array response

掌握对象和数组解析后,网络层返回的数据就可以转换为 Qt 程序中的业务模型。后续开发中应结合接口文档固定字段约束,并对缺失字段和类型变化做好兼容处理。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

解析 JSON 对象和数组

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通