一、摘要
JSON的全称为:JavaScript Object Notation,顾名思义,JSON是用于标记Javascript对象的,JSON官方的解释为:JSON是一种轻量级的数据传输格式。
本文并不详细介绍JSON本身的细节,旨在讨论如何使用C++语言来处理JSON。关于JSON更具体的信息,可参见JSON官网:http://www.json.org。
二、本文选择处理JSON的C++库
本文选择一个第三方库jsoncpp来解析JSON。jsoncpp是比较出名的C++ JSON解析库。在JSON官网也是首推的。
下载地址为:http://sourceforge.net/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");
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 = root.type(); //获得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中进行相应的设置即可