C++解析JSON jsoncpp库

使用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对象等，都很容易使用，大家自己尝试吧。

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中进行相应的设置即可。

直接使用生成的静态库是比较简单的，只要#include“json.h”和 #pragma comment(lib,"json_vc71_libmt.lib")静态库就可以。