2775
来源 | 嵌入式应用研究院
之前一直用的是cJSON库来封装和解析，写久了感觉实在太丑，又难维护，于是还是研究下QT原生的QJson是否有更优雅的方法来封装一些Json对象，果不其然，通过阅读QT开发文档发现，QT封装的Json非常强大，其中Json对象可以有很多种形式，我们看到qjsonobject.h中：
template <class Key, class T> class QMap;
typedef QMap<QString, QVariant> QVariantMap;
template <class Key, class T> class QHash;
typedef QHash<QString, QVariant> QVariantHash;
基于模板创建了QMap和QHash两种容器类型，我们先来介绍QMap和QVariantMap的应用，在介绍QVariantMap的应用之前，先来了解QMap以及QVariant。
1、QMap
QMap是Qt库中的一个关联容器，它存储键值对，其中每个键都是唯一的。这使得你可以通过键值来快速查找或访问存储在QMap中的值。
以下是一些QMap的基本操作：
- 插入：使用insert()函数将一个键值对插入到QMap中。获取值：使用value()函数通过键来获取值。查找：使用find()函数查找具有给定键的键值对。删除：使用remove()函数删除具有给定键的键值对。遍历：使用iterator（如QMapIterator或constIterator）遍历QMap中的所有键值对。
下面是一个简单的QMap使用例子：
#include <QCoreApplication>
#include <QDebug>
#include <QMap>
int main(int argc, char *argv[])
{
QMap<QString, int> map;
map.insert("One", 1);
map.insert("Two", 2);
map.insert("Three", 3);
// 使用value()函数获取值
int one = map.value("One");
qDebug() << "one:" << one;
// 使用constIterator遍历QMap
QMap<QString, int>::const_iterator i;
for (i = map.constBegin(); i != map.constEnd(); ++i) {
qDebug() << "Key: " << i.key() << ", Value: " << i.value();
}
return 0;
}
运行结果：注意，QMap不保证同义词的插入顺序，即如果插入相同的键，第二个插入的键值对将出现在QMap的末尾。如果需要保持插入顺序，可以使用QMap<QString,QList>，其中QList存储与该键关联的值。
2、QVariant
QVariant是一个可以存储多种数据类型的类，它可以方便地在不同的函数、类、模块之间传递数据。QVariant的用法非常简单，只需要使用构造函数、赋值操作符、setValue函数等方法将数据存储到QVariant对象中，然后使用toXXX函数将QVariant对象转换为指定类型的数据。例如：
#include <QCoreApplication>
#include <QDebug>
#include <QVariant>
#include <QDateTime>
int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);
// 存储数据
QVariant v1 = 10; // 存储整数
QVariant v2 = "hello"; // 存储字符串
QVariant v3 = QDateTime::currentDateTime(); // 存储日期时间
// 获取数据
int i = v1.toInt(); // 将 QVariant 转换为整数
QString s = v2.toString(); // 将 QVariant 转换为字符串
QDateTime dt = v3.toDateTime(); // 将 QVariant 转换为日期时间
// 输出数据
qDebug() << "v1 = " << i;
qDebug() << "v2 = " << s;
qDebug() << "v3 = " << dt;
return a.exec();
}
运行结果：
3、QVariantMap
QT的开发者基于QMap及QVariant的优点，于是开发衍生出了QVariantMap。QVariantMap是一个Qt提供的容器类，它可以存储一组键值对，其中键是QString类型，值是QVariant类型。QVariant是一个可以存储多种数据类型的类，包括基本类型、Qt类型和自定义类型。QVariantMap的优点是可以方便地使用字符串作为键来访问或修改值，而不需要像QMap那样指定键的类型。QVariantMap的缺点是它不能保证键的顺序，也不能存储重复的键。它也有很多应用场景，例如：
- 在QML中，可以使用QVariantMap作为C++和JavaScript之间的数据交换格式，因为它可以自动转换为JavaScript对象。在Qt中，可以使用QVariantMap作为JSON对象的表示方式，因为它可以方便地使用QJsonDocument和QJsonObject进行互相转换。在Qt中，可以使用QVariantMap作为数据库查询的结果集，因为它可以方便地使用QSqlQuery和QSqlRecord进行互相转换。在Qt中，可以使用QVariantMap作为配置文件的存储格式，因为它可以方便地使用QSettings进行读写。
QVariantMap在Json对象转换之间的应用，例如，有一个JsonRpc2.0的请求对象:
{
jsonrpc: "2.0",
id: 1,
method: "Set/LedStatus",
params: {
"color": "blue",
"status": "on"
}
}
编写一个程序封装一个基于JsonRpc2.0的请求对象的方法：
QByteArray JsonRpc2ProcotolPacket(int Id, QString Method, const QVariantMap &_Params)
{
QJsonObject RootObject;
QJsonObject Params = QVariant(_Params).toJsonObject();
RootObject.insert("jsonrpc", "2.0");
RootObject.insert("id", Id);
RootObject.insert("method", Method);
RootObject.insert("params", Params);
QJsonDocument JsonDoc(RootObject);
return JsonDoc.toJson();
}
应用主程序调用:
#include <QDebug>
#include <QJsonArray>
#include <QJsonObject>
#include <QJsonDocument>
#include <QCoreApplication>
/*
* Rpc结构
{
jsonrpc: "2.0",
id: 1,
method: "Set/LedStatus",
params: {
"color": "blue",
"status": "on"
}
}
*/
QByteArray JsonRpc2ProcotolPacket(int Id, QString Method, const QVariantMap &_Params)
{
QJsonObject RootObject;
QJsonObject Params = QVariant(_Params).toJsonObject();
RootObject.insert("jsonrpc", "2.0");
RootObject.insert("id", Id);
RootObject.insert("method", Method);
RootObject.insert("params", Params);
QJsonDocument JsonDoc(RootObject);
return JsonDoc.toJson();
}
int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);
//使用QVariantMap封装参数对象部分的数据结构
const QVariantMap &ParamsObject = {
{"color", "blue"},
{"status", "on"}
};
QByteArray JsonStr = JsonRpc2ProcotolPacket(15, "Set/LedStatus", ParamsObject);
qDebug() << JsonStr;
return a.exec();
}
运行结果：
用起来简直不要太爽！
下载ECAD模型
