QT JSON数据格式讲解
@TOC
前言
本篇文章开始带大家学习一下什么是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 数据并解析处理
总结
本篇文章就讲解到这里,希望大家学习后可以自己进行实验验证。
- 点赞
- 收藏
- 关注作者
评论(0)