C++使⽤Json作为数据包装格式的通信
From:
⼀、摘要
JSON 的全称为:JavaScript Object Notation,顾名思义,JSON 是⽤于标记 Javascript 对象的,JSON 官⽅的解释为:JSON 是⼀种轻量级的数据传输格式。
本⽂并不详细介绍 JSON 本⾝的细节,旨在讨论如何使⽤ C++ 语⾔来处理 JSON。关于 JSON 更具体的信息,可参见 JSON 官⽹:。
⼆、本⽂选择处理 JSON的 C++ 库
本⽂选择⼀个第三⽅库 jsoncpp 来解析 JSON。jsoncpp 是⽐较出名的 C++ JSON 解析库。在 JSON 官⽹也是⾸推的。
下载地址为:sourceforge/projects/jsoncpp。本⽂使⽤的 jsoncpp 版本为:0.5.0。
三、jsoncpp 在 Windows 下的编译
要使⽤第三⽅源码库,第⼀步少不了的就是编译,将源码⽂件编译成我们⽅便使⽤的动态链接库、静态链接库或者静态导⼊库[1]。
jsconcpp 进⾏ JSON 解析的源码⽂件分布在 include/json、src/lib_json 下。其实 jsoncpp 源码并不多,为了⽅便产品管理,此处没必要将其编译为动态链接库或者静态导⼊库,所以我们选择使⽤静态链接库[2]。
jsoncpp 已经处理的很完善了,所有编译选项都已经配置好,打开makefiles/vs71/jsoncpp.sln 便可以开始编译(默认是使⽤ VS2003 编译器的,打开时直接按照 VS2005 提⽰转换即可)。
四、jsoncpp 使⽤详解
jsoncpp 主要包含三种类型的 class:Value、Reader、Writer。jsoncpp 中所有对象、类名都在 namespace Json 中,包含 json.h 即可。Json::Value 只能处理 ANSI 类型的字符串,如果 C++ 程序是⽤ Unicode 编码的,最好加⼀个 Adapt 类来适配。
1、Value
Json::Value 是jsoncpp 中最基本、最重要的类,⽤于表⽰各种类型的对象,jsoncpp ⽀持的对象类型可见 Json::ValueType 枚举值。
可如下是⽤ Json::Value 类:
Json::Value json_temp; // 临时对象,供如下代码使⽤
json_temp["name"] = Json::Value("huchao");
js获取json的key和value
json_temp["age"] = Json::Value(26);
Json::Value root; // 表⽰整个 json 对象
root["key_string"] = Json::Value("value_string"); // 新建⼀个 Key(名为:key_string),赋予字符串值:"value_string"。
root["key_number"] = Json::Value(12345); // 新建⼀个 Key(名为:key_number),赋予数值:12345。
root["key_boolean"] = Json::Value(false); // 新建⼀个 Key(名为:key_boolean),赋予bool值:false。
root["key_double"] = Json::Value(12.345); // 新建⼀个 Key(名为:key_double),赋予 double 值:12.345。
root["key_object"] = Json_temp; // 新建⼀个 Key(名为:key_object),赋予 json::Value 对象值。
root["key_array"].append("array_string"); // 新建⼀个 Key(名为:key_array),类型为数组,对第⼀个元素赋值为字符串:"array_string"。root["key_array"].append(1234); // 为数组 key_array 赋值,对第⼆个元素赋值为:1234。
Json::ValueType type = pe(); // 获得 root 的类型,此处为 objectValue 类型。
注:跟C++ 不同,JavaScript 数组可以为任意类型的值,所以 jsoncpp 也可以。
如上⼏个⽤法已经可以满⾜绝⼤部分 json 应⽤了,当然 jsoncpp 还有⼀些其他同能,⽐如说设置注释、⽐较 json ⼤⼩、交换 json 对象等,都很容易使⽤,⼤家⾃⼰尝试吧。
2、Writer
如上说了 Json::Value 的使⽤⽅式,现在到了该查看刚才赋值内容的时候了,查看 json 内容,使⽤ Writer 类即可。
Jsoncpp 的 Json::Writer 类是⼀个纯虚类,并不能直接使⽤。在此我们使⽤ Json::Writer 的⼦类:Json::FastWriter、Json::StyledWriter、Json::StyledStreamWriter。
顾名思义,⽤ Json::FastWriter 来处理 json 应该是最快的,下⾯我们来试试。
Json::FastWriter fast_writer;
std::cout << fast_writer.write(root) << std::endl;
输出结果为:
{"key_array":["array_string",1234],"key_boolean":false,"key_double":12.3450,"key_number":12345,"key_object":
{"age":26,"name":"huchao"},"key_string":"value_string"}
再次顾名思义,⽤ Json::StyledWriter 是格式化后的 json,下⾯我们来看看 Json::StyledWriter 是怎样格式化的。
Json::StyledWriter styled_writer;
std::cout << styled_writer.write(root) << std::endl;
输出结果为:
{
"key_array" : [ "array_string", 1234 ],
"key_boolean" : false,
"key_double" : 12.3450,
"key_number" : 12345,
"key_object" : {
"age" : 26,
"name" : "huchao"
},
"key_string" : "value_string"
}
3、Reader
Json::Reader 是⽤于读取的,说的确切点,是⽤于将字符串转换为 Json::Value 对象的,下⾯我们来看个简单的例⼦。
Json::Reader reader;
Json::Value json_object;
const char* json_document = "{\"age\" : 26,\"name\" : \"huchao\"}";
if (!reader.parse(json_document, json_object))
return 0;
std::cout << json_object["name"] << std::endl;
std::cout << json_object["age"] << std::endl;
输出结果为:
"huchao"
26
可见,上述代码已经解析出了 json 字符串。
--------------------------------------
[1]:使⽤第三⽅源码最简单的⽅法是直接将⽂件加⼊⼯程,但这样不利于源码、软件产品管理,对于⼀般软件开发来说,不建议使⽤。
[2]:如果真需要编译成动态链接库、静态导⼊库的话,可以使⽤ VS 新建⼀个⼯程属性,然后在 Project --> Properties中进⾏相应的设置即可。
--------------------------------------------------------------------------------------------------------------------------------
出处:
Json⼤家都⽿熟能详了吧?现在Json⼴泛⽤于各类通信,特别是基于Http协议的通信,⼀般的服务端动态脚本语⾔都有库⽀持Json的编码与解码。但很少有听过Json被C++使⽤来作为通信的格式,不过去了上⾯看了,已经有很多C++的库来⽀持Json的编码和解码,因为⼀个⼩东西要⽤到,最后使⽤的是这个库。
看到Jsoncpp的主页上介绍说,Jsoncpp是Json数据格式的编码解码器,提供reader和writer来进⾏解码和编码。下⾯就简要的介绍Jsoncpp ⾥头的玩意:
1.Reader
该库中的Reader类⽤来将字串或者流载⼊解析器。是的后期可以⽤Reader⾥⾯的解析⽅法来解码Json字串为C++认识的数据。可以⽤Json::Reader来声明⼀个Reader实例。Reader中最常⽤的就是⼀个parse⽅法,该⽅法⽤来将载⼊的json字串解析为C++格式的数据。
2.Value
这是该库中的核⼼类,⽤于存储各样格式的数据,可以包括int,double,short,char *,string,bool,object,array等⼏乎所有格式的数据。该库的编码和解码的核⼼功能都是⽤Value类实现的。就⽤以上的 Reader的parse⽅法来说,需要传⼊⼀个Value类别的引⽤值,就是⽤来存储Json 数据的根值,并且可以⽤这个根值来存取其他的所有值。
3.Writer
这是该库的⼀个虚类,没有真正的实现encode的功能。需要重载⾥头的⽅法来实现真正的encode功能
4.FastWriter
这是该库中真正实现encode功能的类,⽤来实现将Value编码称为Json串.
我暂时⽤到的是以上的这些类,该库还提供处理Json字串的注释,提供style来格式化Json字串是的更容易⼈阅读等功能,这些都没有⽤到,等以后⽤到了再来分享。下⾯⽤⼀段简短的代码来看以上这些Jsoncpp的基本功能:
上⾯这段代码还是相对⽤到了jsoncpp的⼤部分编码功能的,⽤来将数据编码称为json字符串,下⾯会仔细的分析这段代码
1.⾸先请看注释中的!IN部分,这是这个函数的传⼊参数。有三个⼀个是string类型的token,⼀个是int类型的game_id,⼀个是 array,⽤来存储所有的piece。看!OUT部分就是所要输出的json格式的字符串。⽤后⾯的输出可以看到,这个Json字符串中有⼀个⼤的根 object,⾥头有三样东西,1.token,
2.game_id,
3.piece_array。
⾸先之前已经说过,Value在Jsoncpp中是核⼼类,Reader和Writer都是⽤Value的功能。以上代码中有[]操作符来赋值给 Value,Value应该是类似⼀个map结构的数据仓库,⽤来⽤树存储所有的数据,最后转换后来编码称为Json格式的字符串。在编码数组的过程中 Value提供了⼀个append函数⽤来附加到Value⾥⾯,千万记得我前⾯说过,Value可以直接存数组。当然,Value的[]操作符不能直接的⽤数组作为参数,如果能这样就⽜了。C++这等编译语⾔是做不到这么动态的,所以可以看到代码⾥⾯其实是Value的嵌套,⽤Value来实现⼀个数组元素
的赋值,因为数组元素不是⼀个简单的编译器⽀持的内部类型,所以需要解开来赋值。
最后直接⽤FastWriter来实现编码输出,这样⼀个典型的Jsoncpp的编码Json的过程。
再来看⼀段解码json串的代码
这是⼀段典型的解码json字符串的代码,注释中已经⾮常明⽩的写出了该函数的输⼊和输出,下⾯简要的分析⼀下这段代码
1.parse,这个函数在上⾯的介绍中已经写过,是⽤来解码字串称为Value格式的数据的函数,然后是要判断函数的返回值,如果返回为false,那么说明json字串解码错误。
2.当解码成功以后,就是要操作返回的Value值。这⾥对于如何取Value⾥头的值,Jsoncpp的Value类提供了两个⽅法,⼀个是 get函数,第⼆个是[]操作符,我个⼈觉得还是[]好⽤,传⼊的参数的json⾥头的key,你就可以把key所对应的value取出来
3.当提取出来的是数组时,需要逐个提取⾥⾯的元素,然后再⽤Value的转换功能来实现值的提取。Value提供asXXX函数来转换值。
以上的是简要的介绍了Jsoncpp⾥头的编码和解码功能。

版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。