jsoncpp在linux和windows下的编译及使用详解

一：摘要
1. JSON是一种轻量级的数据传输格式，全称为：JavaScript Object Notation，官方网址： ​​​http://www.json.org/json-zh.html​​​
3. JSONCPP是一个C++用来处理JSON格式数据的第三方库

二：说明 1. 本篇博客下载的是jsoncpp 0.5.0 版本，jsoncpp 0.5.0下载地址：

2. 博客内容及所有代码均是在该版本下编译，运行，测试通过的，示例代码下载地址

三.

Windows下的编译

1.

从上面的地址下载得到jsoncpp-src-0.5.0.tar.gz文件，解压得到jsoncpp-src-0.5.0文件夹

2.

进入目录 jsoncpp-src-0.5.0/makefiles/vs71，打开解决方案jsoncpp.sln（注意vs71也就是VS2003，如果你的VS版本较高，默认转换即可，不会出什么问题）

3.

该解决方案中有三个工程，分别为jsontest，lib_json，test_lib_json

4.

不需任何操作，直接编译工程lib_json，默认是Debug版，该工程为静态库文件工程，最终产生lib文件，产生的库文件为json_vc71_libmtd.lib，全路径为：jsoncpp-src-

0.5.0/build/vs71/debug/lib_json/json_vc71_libmtd.lib，注意产生库文件名字中的 "mtd"字样，这个是编译参数，说明编译的是多线程调试版，mtd的意思即Multi Debug，。当然你也可以编译release版

四.

Windows下的使用

1.

切记：示例工程所用的Visual Studio和步骤三的编译库所用的Visual Studio 是同一版本。如果两次所用VS的版本不同，链接静态库时很可能会出现链接错误，笔者已踩过此坑）

2.

建立一个空的win32控制台工程，类似HellowWorld的工程即可，我这里工程命名为jsoncppExample

3.

在本示例工程根目录添加include文件夹，把jsoncpp-src-0.5.0/include/json文件夹整个拷贝到include下面，在属性页 配置属性 -> C/C++ -> 常规 -> 附加包含目录 中设置该工程的头文件目录，即“../include”

4.

在本示例工程根目录添加lib文件夹,把刚才编译的json静态库拷贝到lib下面，即上面的库文件json_vc71_libmtd.lib，在属性页 配置属性 -> 链接器 -> 常规 -> 附加库目录 中设置该工程

的静态库目录，即“../lib”；在属性页 配置属性 -> 链接器 -> 输入 -> 附加依赖项 中设置该工程的静态库的名字，即“json_vc71_libmtd.lib”

5.

在属性页 配置属性 -> C/C++ -> 代码生成 -> 运行时库 中设置为“多线程调试（/MTd）”，即和上面编译库时的选项一致

6. 添加一个源文件main.cpp，代码如下：

#include <iostream>
#include <fstream>
#include "json/json.h"
using namespace std;

int main()
{
  ///
  /                                 json Value的新建及key的访问                  ///
  ///

  cout<<"json Value的新建及key的访问"<<endl;

  // 新建Json::Value对象
  Json::Value value1;

  // 给字段赋值，key必须为string型
  // 类似STL的map，访问一个不存在的字段时会自动新建一个字段 
  value1["name"] = "英语";        // string型
  
  Json::Value value2;
  value2["name"]    = "语文";   // string型
  value2["score"]   = 80;     // 整型
  value2["right"]   = true;     // bool型
  value2["percent"] = 12.34567890;  // double型
  value2["count"];          // 单纯的访问一个key，由于该key不存在，所以会新建，值的类型为Json::nullValue
  
  // 新建Value对象
  Json::Value valueArr;
  valueArr["name"]  = "json array"; // string型
  valueArr["object"]  = value1;   // json::Value型
  valueArr["array"].append("array_element_one");  // 访问key为"array"，该key不存在，会新建，类型为Json::arrayValue，数组型，且把第一个元素赋值为string型"array element one"
  valueArr["array"].append("array_element_two");  // 该key已存在，往后面增加元素，赋值为string型"array element two"
  valueArr["array"].append(33333);        // 该key已存在，往后面增加元素，赋值为整型33333
  valueArr["array"].append(value2);       // 该key已存在，往后面增加元素，赋值为json::Value型

  // 计算其中字段的个数
  cout<<"size = "<<valueArr.size()<<endl;

  // key的访问

  // 访问字段"object"的值，访问一个key前，先预判是否有该key
  if (valueArr.isMember("object"))
  {
    // 存在的话，再判断其value的类型是否是自己预期的,根据前面32行赋值代码可知："object"的值是Json::Value类型
    if (valueArr["object"].isObject())
    {
      // 转换成对应的类型
      Json::Value object = valueArr["object"];

      // 字段检测，取值，可以放在一行中，谨记：先检测是否存在，后判断类型
      if (object.isMember("name") && object["name"].isString())
      {
        string name = object["name"].asString();
        cout<<"valueArr[object] key = name, value = "<< name.c_str()<<endl;
      }
    }   
  }

  // 访问字段"array"的值
  if (valueArr.isMember("array") && valueArr["array"].isArray()) // 根据前面33行赋值代码可知："object"的值是Json::arrayValue类型的
  {
    // 注意：虽然类型为Json::arrayValue，也是转换为Json::Value类型的
    Json::Value arrayObject  = valueArr["array"];

    // 得到其元素个数
    int array_size = arrayObject.size();

    // 根据类型，逐个输出元素
    for(int i=0; i<array_size; i++)
    {
      // 若是Json::Value型
      if (arrayObject[i].isObject())
      {
        // 转换成对应的类型
        Json::Value object = arrayObject[i];

        // 字段检测，取值
        if (object.isMember("score") && object["score"].isInt())
        {
          int score = object["score"].asInt();
          cout<<"valueArr[array][" << i <<"]" << " key = score, value = "<< score<<endl;
        }

        // 字段检测，取值
        if (object.isMember("percent") && object["percent"].isDouble())
        {
          double percent = object["percent"].asDouble();
          cout<<"valueArr[array][" << i <<"]" << " key = percent, value = "<< percent<<endl;
        }
      }

      // 若是string类型
      if (arrayObject[i].isString())
      {
        cout<<"valueArr[array][" << i <<"] value is " << arrayObject[i].asString()<<endl;
      }

      // 若是整型
      if (arrayObject[i].isInt())
      {
        cout<<"valueArr[array][" << i <<"] value is " << arrayObject[i].asInt()<<endl;
      }
    }
  }
  cout<<"\n\n"<<endl;
  
  //
  /             把Json::Value转换成字符串              //
  //

  cout<<"把Json::Value转换成字符串"<<endl;
  cout<<valueArr.toStyledString()<<endl;
  cout<<"\n\n"<<endl;

  //
  /             从字符串中解析出json::Value           //
  //


  cout<<"从字符串中解析出json::Value"<<endl;
  // 要解析的json字符串
  std::string strValue = "{\"key1\":\"value1\",\"array\":[{\"key2\":\"value2\"},{\"key2\":999},{\"key2\":\"value4\"}]}";

  // json对象
  Json::Value value3;

  // 开始解析json，解析后的json对象存储在value中，成功返回true
  Json::Reader reader;
  if (reader.parse(strValue, value3))
  {   
    // 字段key1
    if (value3.isMember("key1") && value3["key1"].isString())
    {
      cout<<"value3[key1] = "<<value3["key1"].asString()<<endl;
    }

    // 字段array
    if (value3.isMember("array") && value3["array"].isArray())
    {
      Json::Value valueArray = value3["array"];

      for (int i=0; i<valueArray.size(); i++)
      {
        if (valueArray[i].isObject() && valueArray[i].isMember("key2") && valueArray[i]["key2"].isString())
        {
          cout<<"value3[array]["<<i<<"].[key2] = "<<valueArray[i]["key2"].asString()<<endl;
        }

        if (valueArray[i].isObject() && valueArray[i].isMember("key2") && valueArray[i]["key2"].isInt())
        {
          cout<<"value3[array]["<<i<<"].[key2] = "<<valueArray[i]["key2"].asInt()<<endl;
        }
      }
    }
  }
  cout<<"\n\n"<<endl;

  //
  ///             把json::Value写入到文件中              //
  //

  cout<<"把json::Value写入到文件中"<<endl;

  ofstream ofs;
  ofs.open("test.json");

  // 第一种办法：直接输出，带缩进，效果等同于第三种办法
  //ofs << valueArr.toStyledString();
  

  // 第二种办法：快速输出，没有格式
  //Json::FastWriter fw;
  //ofs<<fw.write(valueArr)<<endl;

  // 第三种办法：缩进输出
  Json::StyledWriter sw;
  ofs<<sw.write(valueArr)<<endl;

  ofs.close();
  cout<<"输出到文件完毕"<<endl;
  cout<<"\n\n"<<endl;

  //
  ///             从文件中读取json::Value             //
  //

  cout<<"从文件中读取到json:value"<<endl;
  ifstream ifs;
  ifs.open("test.json");
  
  Json::Value value4;

  Json::Reader jsonReader;
  if (jsonReader.parse(ifs, value4))
  {
    // 得到字段的个数
    cout<<"size = "<<value4.size()<<endl;

    // 访问
    if (valueArr.isMember("name") && valueArr["name"].isString())
    {
      cout<<"valueArr[name] = "<<valueArr["name"].asString()<<endl; 
    }
  }

  getchar();
  return 0;
}

五. Linux下的编译

1.   在linux下编译jsoncpp需要使用scons，一个类似make的编译工具。安装scons需要pyhon，centos系统自带python，如果没有请自行安装，这个简单，注意pyhon版本需为2.7或者以下

2.   安装scons，下载地址

​​javascript:void(0)​​。笔者这里是下载到/home/scons/ 目录下。进入目录 /home/scons/，执行解压缩命令 tar -zxvf scons-2.5.1.tar.gz。设置两个环境变量 export MYSCONS=/home/scons/scons-2.5.1 ，export SCONS_LIB_DIR=$MYSCONS/engine 。这两个环境变量至关重要

3.   编译jsoncpp，笔者这里是下载到/home/jsoncpp/ 目录下。进入目录 /home/jsoncpp/，执行解压缩命令 tar -zxvf jsoncpp-src-0.5.0.tar.gz，再进入目录 /home/jsoncpp/jsoncpp-src-0.5.0/，执行编译命令 python $MYSCONS/script/scons platform=linux-gcc，即可编译jsoncpp，随后会生成静态库和动态库文件，在目录jsoncpp-src-0.5.0/libs/linux-gcc-4.4.7中。分别是静态库libjson_linux-gcc-4.4.7_libmt.a，动态库libjson_linux-gcc-4.4.7_libmt.so

六. Linux下的使用

1.   代码与步骤四中windows下的代码完全相同，需编写makefile，示例代码中有