JsonCpp的基本用法

1、JsonCpp
C++库，允许操作JSON值，包括与字符串串行化和序列化。它可在反序列化/序列化步骤中保留现有注释，使其成为存储用户输入文件的便捷方式。是一个第三方JSON解析库，可将源码编译成方便使用动态链接库、静态链接库或者静态导入库的。jsconcpp 进行 JSON 解析的源码文件分布在 include/json、src/lib_json 下。
JsonCpp（1.8.4版本）：https://github.com/open-source-parsers/jsoncpp/tree/1.8.4

2、JsonCpp编译工具
（1）Cmake
是一个跨平台的安装（编译）工具，可以用简单的语句来描述所有平台的安装(编译过程)。他能够输出各种各样的makefile或者project文件，能测试编译器所支持的C++特性,类似UNIX下的automake。Cmake 并不直接建构出最终的软件，而是产生标准的建构档（如 Unix 的 Makefile 或 Windows Visual C++ 的 projects/workspaces），然后再依一般的建构方式使用。
（2）Mesos
scons：Python写的自动化构建工具，是一个更简便，更可靠，更高效的编译软件，可用于编译jsoncpp。
（3）Doxygen
用于带注释的C++源生成文档的事实上的标准工具。程序的文件产生工具，可将程序中的特定注释转换为说明文件。能依据程序本身的结构，将注释经过处理重新整理成为一个纯粹的参考手册。
3、JsonCpp编译
除了使用以上工具编译外，还可以使用visual studio编译。
（1）用VS打开jsoncpp-1.8.4\makefiles\vs71 /jsoncpp.sln 便可以开始编译。
（2）打开vs2013 点击项目lib_json右键-属性-C/C++ -代码生成 选择多线程调试（MTD）
（3）调试修改为 debug右键按下鼠lib_json 选择生成，则在jsoncpp-1.8.4\build\vs71\debug\lib_json生成json_vc71_libmtd.lib（注意最后为libmtd）。vs2013自动编译项目。（如果为release，则相对于生成releas版本为json_vc71_libmt.lib（最后为libmt））

（4）编译后在jsoncpp-1.8.4\build\vs71\release\lib_json找到json_vc71_libmtd.lib将其复制到vs工程的的lib里（即直接复制到项目中）

（5）在项目中右击—配置—配置属性—C/C++ --代码生成—运行库—多线程（/MTD）（注意与上面的lib的生成版本有关，要改为对应的形式）

（6）在项目中右击—配置—配置属性–链接器–输入—附加依赖项，最后添加json_vc71_libmtd.lib，（或者在cpp源代码中添加#pragma comment(lib, “json_vc71_libmtd.lib”)）

（7）将jsoncpp的头文件include复制到vs的include.，并在项目中引入，然后就可以使用了

4、JsonCpp基础
jsonCpp主要包含三种类型的class：value、reader、write。jsonCpp总所有对象、类名都在namespace json中，使用时只要包含json.h即可。
（1）Json::Value
Json::Value时jsonCpp中最基本、最重要的类，用于表示各种类型的对象，jsoncpp 支持的对象类型可见 Json::ValueType 枚举值。
例：

Json::Value root;
root["status"] = 1;			//新建一个key为status，赋予数值1
root["message"] = "OK";		//新建一个key为message，赋予字符串OK
root["array"].append("arr"); //新建一个key为array，类型为数组，对第一个元素赋值为字符串“arr”
root["array"].append(1234);  // 为数组 key_array 赋值，对第二个元素赋值为：1234。
Json::ValueType type = root.type();	//获得root的类型

注：a、跟C++ 不同，JavaScript 数组可以为任意类型的值，所以 jsoncpp 也可以。
jsoncpp 还有一些其他同能，比如说设置注释、比较 json 大小、交换 json 对象等
b、在把value插入值后再输出来，输出的值是按字母表的顺序排列。
c、Json::ValueType：value的类型，是一个枚举型

enum ValueType {
  nullValue = 0, ///< 'null' value
  intValue,      ///< signed integer value
  uintValue,     ///< unsigned integer value
  realValue,     ///< double value
  stringValue,   ///< UTF-8 string value
  booleanValue,  ///< bool value
  arrayValue,    ///< array value (ordered list)
  objectValue    ///< object value (collection of name/value pairs).
};

（2）Json::Writer
a、Json::Writer负责将内存中的Value对象转换成JSON文档，输出到文件或者是字符串中。
b、Json::Writer是一个纯虚类，不能直接使用，一般使用Json::Writer的子类：Json::FasterWriter, Json::StyledWriter、Json::StyledStreamWriter
注：在新版中Json::FasterWriter, Json::StyledWriter、Json::Reader都被弃用，替代的是Json::StreamWriterBuilder、Json::CharReaderBuilder
c、Json::FasterWriter：速度最快
d、Json::StyledWriter：格式化后的json

（3）Josn::Reader
用于读取，准确说是用于将字符串或者文件输入流转换为Json::Value对象的。
parse()
a、使用Json::Reader对json文件进行解析
bool parse(const std::string& document, Value& root, bool collectComments = true);
参数：document: 包含要读取的文档的UTF-8编码字符串
root:（输出）Json::Value的对象

b、使用Json::Reader对json输入流（文件）进行解析
bool parse(std:stream& is, Value& root, bool collectComment = true);

c、使用Json::Reader对字符串进行解析
bool parse(const char* beginDoc, const char* ednDoc, Value& root, bool collectComment = true);

（4）JsonCpp其他操作
a、判断key是否存在
bool Json::Value::isMember ( const char * key) const；
存在返回1，否则返回0

b、判断是否为null成员函数
注：Json::Value和C++中的map有一个共同的特点，就是当你尝试访问一个不存在的 key 时，会自动生成这样一个key-value默认为null的值对。

c、得到所有成员
typedef std::vectorstd::string Json::Value::Members;
Value::Members Json::Value::getMemberNames ( ) const;
该函数的类型为一个string的vector。

d、删除成员
Value Json::Value::removeMember( const char* key)
返回删除的值，或者null

5、测试实例

#include <iostream>
#include <fstream>
#include <string>
#include "json/json.h"

using namespace std;

int main()
{
	const char* age;
	Json::Value root;
	Json::FastWriter fast_writer;
	Json::StyledWriter style_writer;
	Json::StyledStreamWriter stream_writer;
	Json::Reader reader;
	Json::Value json_object;

	root["null"] = NULL;			//注意此处在输出是显示为0，而非null
	root["message"] = "OK";
	root["age"] = 52;
	root["array"].append("arr");	// 新建一个key为array，类型为数组，对第一个元素赋值为字符串“arr”
	root["array"].append(123);		// 为数组 key_array 赋值，对第二个元素赋值为：1234

	Json::ValueType type = root.type();				//root的类型

	cout << root.toStyledString() << endl;			//格式化输出
	cout << "root_type：" <<type << endl;			//类型为7，即为类型为对象

	// 写到本地文件
	cout << "快速输出：" << endl;
	string str = fast_writer.write(root);
	cout << str << endl;		//快速输出,紧凑型
	ofstream ofs("fast_writer.json");
	ofs << str;
	ofs.close();

	cout << "格式化输出：" << endl;
	str = style_writer.write(root);
	cout << str << endl;		//格式化输出，排版型
	ofs.open("style_writer.json");
	ofs << str;
	ofs.close();


	// 对字符串解析
	//const char* json_document = "{\"age\" : 12, \"name\" : \"weng\"}";
	string json_document = "{\"age\" : 123, \"name\" : \"weng\"}";
	if (!reader.parse(json_document, json_object)){
		cout << "error" << endl;
		return 0;
	}
	else{
		cout <<"age:" <<json_object["age"] << " name" << json_object["name"] << endl;
	}
	
	// 对文件解析
	ifstream ifs("E:\\demo\\JsonTest\\JsonTest\\example.json", ios::binary);
	if (!reader.parse(ifs, json_object)){
		cout << "open error" << endl;
		ifs.close();
	}else{
		cout << "encoding:" << json_object["encoding"].asString() << endl;
		cout << "age:" <<json_object["age"].asInt() << endl;
		int num = json_object["plug"].size();
		for (int i = 0; i < num; i++){
			cout << json_object["plug"][i].asString() << " ";
		}
		ifs.close();
		cout << endl;
	}

	// 判断key是否存在
	bool is_age =  root.isMember("age");
	cout << "isMember:" <<is_age << endl;

	// 判断是否为null
	//bool is_null = root["null"].isNull();			//注意此处被赋值为0，而非null
	bool is_null = json_object["null"].isNull();
	cout << "is_null:" << is_null << endl;

	// 得到所有的key
	for (auto elem : root.getMemberNames()){
		cout << elem << " ";
	}
	cout << endl;

	// 删除成员
	cout << "remove_age:" << root.removeMember("age") << endl;


	system("pause");
	return 0;
}