Qt中Json的操作
Qt中Json的操作
苏丙榅在 Json的两种格式中介绍了Json的格式以及应用场景。由于这种数据格式与语言无关,下面介绍一下Json在Qt中的使用。
从Qt 5.0
开始提供了对Json的支持,我们可以直接使用Qt提供的Json类进行数据的组织和解析。相关的类常用的主要有四个,具体如下:
Json类 | 介绍 |
---|---|
QJsonDocument |
它封装了一个完整的JSON文档,并且可以从UTF-8编码的基于文本的表示以及Qt自己的二进制格式读取和写入该文档。 |
QJsonArray |
JSON数组是一个值列表。可以通过从数组中插入和删除QJsonValue来操作该列表。 |
QJsonObject |
JSON对象是键值对的列表,其中键是唯一的字符串,值由QJsonValue表示。 |
QJsonValue |
该类封装了JSON支持的数据类型。 |
1. QJsonValue
在Qt中QJsonValue
可以封装的基础数据类型有六种(和Json支持的类型一致),分别为:
- 布尔类型:
QJsonValue::Bool
- 浮点类型(包括整形):
QJsonValue::Double
- 字符串类型:
QJsonValue::String
- Json数组类型:
QJsonValue::Array
- Json对象类型:
QJsonValue::Object
- 空值类型:
QJsonValue::Null
这个类型可以通过QJsonValue
的构造函数被封装为一个类对象:
1 | // Json对象 |
如果我们得到一个QJsonValue
对象,如何判断内部封装的到底是什么类型的数据呢?这时候就需要调用相关的判断函数了,具体如下:
1 | // 是否是Json数组 |
通过判断函数得到对象内部数据的实际类型之后,如果有需求就可以再次将其转换为对应的基础数据类型,对应的API函数如下:
1 | // 转换为Json数组 |
2. QJsonObject
QJsonObject
封装了Json中的对象,在里边可以存储多个键值对,为了方便操作,键值为字符串类型,值为QJsonValue
类型。关于这个类的使用类似于C++中的STL类,仔细阅读API文档即可熟练上手使用,下面介绍一些常用API函数:
如何创建空的Json对象
1
QJsonObject::QJsonObject(); // 构造空对象
将键值对添加到空对象中
1
iterator QJsonObject::insert(const QString &key, const QJsonValue &value);
获取对象中键值对个数
1
2
3int QJsonObject::count() const;
int QJsonObject::size() const;
int QJsonObject::length() const;通过key得到value
1
2
3
4QJsonValue QJsonObject::value(const QString &key) const; // utf8
QJsonValue QJsonObject::value(QLatin1String key) const; // 字符串不支持中文
QJsonValue QJsonObject::operator[](const QString &key) const;
QJsonValue QJsonObject::operator[](QLatin1String key) const;删除键值对
1
2void QJsonObject::remove(const QString &key);
QJsonValue QJsonObject::take(const QString &key); // 返回key对应的value值通过key进行查找
1
2iterator QJsonObject::find(const QString &key);
bool QJsonObject::contains(const QString &key) const;遍历,方式有三种:
使用相关的迭代器函数
使用 [] 的方式遍历, 类似于遍历数组, []中是键值
先得到对象中所有的键值, 在遍历键值列表, 通过key得到value值
1
QStringList QJsonObject::keys() const;
3. QJsonArray
QJsonArray
封装了Json中的数组,在里边可以存储多个元素,为了方便操作,所有的元素类统一为QJsonValue
类型。关于这个类的使用类似于C++中的STL类,仔细阅读API文档即可熟练上手使用,下面介绍一些常用API函数:
创建空的Json数组
1
QJsonArray::QJsonArray();
添加数据
1
2
3
4
5
6void QJsonArray::append(const QJsonValue &value); // 在尾部追加
void QJsonArray::insert(int i, const QJsonValue &value); // 插入到 i 的位置之前
iterator QJsonArray::insert(iterator before, const QJsonValue &value);
void QJsonArray::prepend(const QJsonValue &value); // 添加到数组头部
void QJsonArray::push_back(const QJsonValue &value); // 添加到尾部
void QJsonArray::push_front(const QJsonValue &value); // 添加到头部计算数组元素的个数
1
2int QJsonArray::count() const;
int QJsonArray::size() const;从数组中取出某一个元素的值
1
2
3
4QJsonValue QJsonArray::at(int i) const;
QJsonValue QJsonArray::first() const; // 头部元素
QJsonValue QJsonArray::last() const; // 尾部元素
QJsonValueRef QJsonArray::operator[](int i);删除数组中的某一个元素
1
2
3
4
5
6
7iterator QJsonArray::erase(iterator it); // 基于迭代器删除
void QJsonArray::pop_back(); // 删除尾部
void QJsonArray::pop_front(); // 删除头部
void QJsonArray::removeAt(int i); // 删除i位置的元素
void QJsonArray::removeFirst(); // 删除头部
void QJsonArray::removeLast(); // 删除尾部
QJsonValue QJsonArray::takeAt(int i); // 删除i位置的原始, 并返回删除的元素的值Josn数组的遍历,常用的方式有两种:
- 可以使用迭代器进行遍历(和使用迭代器遍历STL容器一样)
- 可以使用数组的方式遍历
4. QJsonDocument
它封装了一个完整的JSON文档,并且可以从UTF-8编码的基于文本的表示以及Qt自己的二进制格式读取和写入该文档。QJsonObject 和 QJsonArray
这两个对象中的数据是不能直接转换为字符串类型的,如果要进行数据传输或者数据的持久化,操作的都是字符串类型而不是 QJsonObject
或者 QJsonArray
类型,我们需要通过一个Json文档类进行二者之间的转换。
下面依次介绍一下这两个转换流程应该如何操作:
QJsonObject 或者 QJsonArray
===>字符串
创建
QJsonDocument
对象1
2QJsonDocument::QJsonDocument(const QJsonObject &object);
QJsonDocument::QJsonDocument(const QJsonArray &array);可以看出,通过构造函数就可以将实例化之后的**
QJsonObject 或者 QJsonArray
**转换为QJsonDocument
对象了。将文件对象中的数据进行序列化
1
2
3
4// 二进制格式的json字符串
QByteArray QJsonDocument::toBinaryData() const;
// 文本格式
QByteArray QJsonDocument::toJson(JsonFormat format = Indented) const;通过调用
toxxx()
方法就可以得到文本格式或者二进制格式的Json字符串了。使用得到的字符串进行数据传输, 或者磁盘文件持久化
字符串
===>QJsonObject 或者 QJsonArray
一般情况下,通过网络通信或者读磁盘文件就会得到一个Json格式的字符串,如果想要得到相关的原始数据就需要对字符串中的数据进行解析,具体解析流程如下:
将得到的Json格式字符串通过
QJsonDocument
类的静态函数转换为QJsonDocument
类对象1
2
3[static] QJsonDocument QJsonDocument::fromBinaryData(const QByteArray &data, DataValidation validation = Validate);
// 参数文件格式的json字符串
[static] QJsonDocument QJsonDocument::fromJson(const QByteArray &json, QJsonParseError *error = Q_NULLPTR);将文档对象转换为json数组/对象
1
2
3
4
5
6
7
8
9// 判断文档对象中存储的数据是不是数组
bool QJsonDocument::isArray() const;
// 判断文档对象中存储的数据是不是json对象
bool QJsonDocument::isObject() const
// 文档对象中的数据转换为json对象
QJsonObject QJsonDocument::object() const;
// 文档对象中的数据转换为json数组
QJsonArray QJsonDocument::array() const;通过调用
QJsonArray
,QJsonObject
类提供的 API 读出存储在对象中的数据。
关于Qt中Json数据对象以及字符串之间的转换的操作流程是固定的,我们在编码过程中只需要按照上述模板处理即可,相关的操作是没有太多的技术含量可言的。
5. 举例
5.1 写文件
1 | void writeJson() |
5.2 读文件
1 | void MainWindow::readJson() |
一般情况下,对于Json字符串的解析函数都是有针对性的,因为需求不同设计的Json格式就会有所不同,所以不要试图写出一个通用的Json解析函数,这样只会使函数变得臃肿而且不易于维护,每个Json格式对应一个相应的解析函数即可。
上面的例子中为了给大家演示Qt中Json类相关API函数的使用将解析步骤写的复杂了,因为在解析的时候我们是知道Json对象中的所有key值的,可以直接通过key值将对应的value值取出来,因此上面程序中的一些判断和循环其实是可以省去的。