前言
本篇文章开始带大家学习一下什么是JSON，并且学习QT当中的JSON使用。
一、JSON是什么
JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，用于在不同系统之间传输和存储数据。它采用人类可读的文本格式，并使用键值对的形式组织数据。
JSON由两种基本的数据结构组成：
1.对象（Object）：对象是一个无序的集合，表示为键值对的集合。键是字符串，值可以是任意数据类型，包括字符串、数字、布尔值、数组、另一个对象以及null。对象使用花括号 {} 包围，键值对由冒号 : 分隔，键值对之间使用逗号 , 分隔。
例如：
{ "name": "John", "age": 30, "isStudent": true, "hobbies": ["reading", "cooking"], "address": { "street": "123 Main St", "city": "New York" }, "isActive": null }
2.数组（Array）：数组是一个有序的集合，表示为值的有序列表。值可以是任意数据类型，包括字符串、数字、布尔值、数组、对象以及null。数组使用方括号 [] 包围，值之间使用逗号 , 分隔。
例如：
[10, 20, 30, "hello", true, null]
JSON的特点包括：
简洁性：JSON使用简洁的文本格式表示数据，易于阅读和编写。
可读性：由于采用了常见的键值对和列表结构，使得数据易于理解和解释。
可扩展性：JSON支持嵌套的对象和数组结构，可以表示复杂的数据关系。
平台无关性：JSON是一种独立于平台和语言的数据交换格式，可以被大多数编程语言支持和解析。
JSON广泛应用于Web开发、API设计、配置文件、数据存储等领域，因为它在不同系统和应用之间提供了一种通用的数据交换方案，使得数据传输和解析变得简单和灵活。
二、JSON在线解析
JSON在线解析工具：
我们可以使用上面这个JSON在线解析网站来帮助我们解析JSON的数据：
当把对应的JSON数据放入时就会自动的帮我们解析出来，这样我们就可以清楚的看出每一个JSON数组和JSON对象的组成了。
三、QT中的JSON类
在Qt中，提供了一些用于处理JSON数据的相关类，用于解析、生成和操作JSON数据。以下是一些常用的Qt中与JSON相关的类：
1.QJsonDocument：QJsonDocument类用于表示和操作JSON文档。它可以从JSON字符串中解析数据，或将数据转换为JSON字符串。还提供了方法来检索和修改JSON数据。
2.QJsonObject：QJsonObject类表示JSON中的对象。它由一组键值对组成，其中键是字符串，值可以是任意的QJsonValue。可以通过QJsonObject的方法来添加、获取和修改键值对。
3.QJsonArray：QJsonArray类表示JSON中的数组。它是一组有序的QJsonValue元素，可以通过索引访问其中的元素。QJsonArray提供了方法来添加、获取和修改数组元素。
4.QJsonValue：QJsonValue类是一个通用的JSON值类。它可以表示JSON中的字符串、数字、布尔值、对象、数组和null。QJsonValue提供了方法来获取和检查值的类型，以及将其转换为不同的数据类型。
5.QJsonParseError：QJsonParseError类用于表示JSON解析过程中的错误。它包含了错误的类型和位置信息，可以使用它来判断解析是否成功以及出现的错误类型。
这些类位于Qt的QJson模块中，可以使用#include <QJsonDocument>等语句包含相应的头文件。Qt提供了丰富的API和方法，使得在Qt应用程序中处理JSON数据变得简单和方便。
四、构建JSON字符串
这里我们使用代码来构建JSON字符串：
#include <QCoreApplication> #include <QJsonArray> #include <QJsonDocument> #include <QJsonValue> #include <QJsonObject> #include <QDebug> #include <QByteArray> void ConstructJSONString() { // 创建 JSON 对象 QJsonObject root; root.insert("name", "John"); root.insert("age", "30"); root.insert("isStudent", "true"); // 创建字符串数组 QJsonArray hobbiesArray; hobbiesArray.append("reading"); hobbiesArray.append("cooking"); root.insert("hobbies", hobbiesArray); // 创建嵌套的 JSON 对象 QJsonObject addressObj; addressObj.insert("street", "123 Main St"); addressObj.insert("city", "New York"); root.insert("address", addressObj); root.insert("isActive", "null"); // 创建 JSON 文档 QJsonDocument jsonDoc(root); QByteArray json = jsonDoc.toJson(); qDebug() << QString(json).toUtf8().data(); } int main(int argc, char *argv[]) { QCoreApplication a(argc, argv); ConstructJSONString(); return a.exec(); }
运行结果：
可以看到成功的打印出了JSON类型的字符串。
五、解析JSON数据
void ParseJson() { QString jsonString = R"({ "address": { "city": "New York", "street": "123 Main St" }, "age": "30", "hobbies": [ "reading", "cooking" ], "isActive": "null", "isStudent": "true", "name": "John" })"; QJsonDocument jsonDoc = QJsonDocument::fromJson(jsonString.toUtf8()); // 获取根对象 QJsonObject jsonObj = jsonDoc.object(); // 从根对象中提取所需的值 QString name = jsonObj["name"].toString(); QString age = jsonObj["age"].toString(); QString isStudent = jsonObj["isStudent"].toString(); QJsonValue addressValue = jsonObj["address"]; if (addressValue.isObject()) { QJsonObject addressObj = addressValue.toObject(); QString city = addressObj["city"].toString(); QString street = addressObj["street"].toString(); qDebug() << "Address: " << city << street; } QJsonValue hobbiesValue = jsonObj["hobbies"]; if (hobbiesValue.isArray()) { QJsonArray hobbiesArray = hobbiesValue.toArray(); QStringList hobbies; for (const QJsonValue& hobbyValue : hobbiesArray) { if (hobbyValue.isString()) { QString hobby = hobbyValue.toString(); hobbies.append(hobby); } } qDebug() << "Hobbies: " << hobbies; } QJsonValue isActiveValue = jsonObj["isActive"]; if (isActiveValue.isNull()) { qDebug() << "isActive is null"; } // 输出解析结果 qDebug() << "Name: " << name; qDebug() << "Age: " << age; qDebug() << "isStudent: " << isStudent; }
六.核心类QJsonDocument 类详解
QJsonDocument 类是 Qt 框架提供的用于操作 JSON 数据的类之一。它提供了将 JSON 数据与 JSON 字符串之间进行转换的功能。以下是对 QJsonDocument 类的一些讲解以及它可以进行 JSON 字符串和 JSON 数据之间转换的原因：
1.解析 JSON 字符串：
QJsonDocument 可以将符合 JSON 格式的字符串解析为对应的 JSON 数据结构。通过调用静态函数 QJsonDocument::fromJson()，将 JSON 字符串作为参数传递给该函数，它将返回一个解析后的 QJsonDocument 对象。在解析过程中，QJsonDocument 验证 JSON 字符串的语法和格式，并构建相应的 JSON 数据对象。
2.创建 JSON 字符串：
QJsonDocument 对象可以将 JSON 数据结构转换回 JSON 字符串。通过调用 QJsonDocument::toJson() 函数来获取 JSON 数据对象的字符串表示。该函数提供了多个重载版本，允许设置不同的格式选项（如缩进、格式化等），以满足不同的需求。
3.JSON 数据访问和操作：
QJsonDocument 使得操作 JSON 数据变得更加简单和方便。通过 QJsonDocument 对象，可以获得顶层的 QJsonObject 或 QJsonArray 对象，从而访问和操作 JSON 数据的键值对、数组元素等。这些对象提供了一系列的成员函数（如 value(), insert(), remove(), toArray(), toObject() 等），方便对 JSON 数据进行读取、修改和操作。
QJsonDocument 类之所以能实现在 JSON 字符串和 JSON 数据之间进行转换，是因为它基于 Qt 的 JSON 解析库实现，并提供了解析 JSON 字符串和构建 JSON 数据对象的功能。这种转换能力使得开发者可以方便地在 Qt 应用程序中处理和操作 JSON 数据，与其他组件或服务进行数据交换，以及从网络等源获取 JSON 数据并解析处理
总结
本篇文章就讲解到这里，希望大家学习后可以自己进行实验验证。
