使用 C++ 处理 JSON 数据交换格式

一、摘要

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 对象等，都非常easy使用，大家自己尝试吧。

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 字符串。

4、以下这段代码演示了怎么使用Json中的值

std::string test = "{\"test\":5,\\"Value\":{\"version\":\"this is version\"}}";Json::Reader reader;Json::Value value;if(reader.parse(test,value))
{int i = 0;bool isNull = value["test"].isNull();if(!isNull)                  i = value["test"].asInt();if(!value["Value"]["version"].isNull()){std::string str = value["Value"]["version"].asString();   }Json::Value val1= value["OtherKey"];    if(!val1.isNull()){i = val1.asInt();              }}

--------------------------------------

[1]：使用第三方源代码最简单的方法是直接将文件增加project，但这样不利于源代码、软件产品管理，对于一般软件开发来说，不建议使用。

[2]：假设真须要编译成动态链接库、静态导入库的话，能够使用 VS 新建一个project属性，然后在Project --> Properties中进行对应的设置就可以。