C++ Builder 解析和生成 json (使用 jsoncpp (0.y.z))

jsoncpp 的 0.y.z 分支适用于早期版本的编译器，低版本的 C++ Builder 也可以使用。
下载和编译 jsoncpp 0.y.z 可以参考 《C++ Builder 编译 jsoncpp 库 (0.y.z 分支)》
master 分支的 jsoncpp 已经不使用本文的解析和生成 json 的方法了。

• 使用 jsoncpp 静态库
• 解析 json
  · 解析 json 字符串
  · 解析 json 文件
• 生成 json
  · 一般格式 toStyledString
  · 压缩格式 FastWriter
  · 保存 json 文件
• 下载本文例子源码

---

一. 使用 jsoncpp 静态库

1. 下载和编译 jsoncpp 静态库

下载和编译 jsoncpp 0.y.z 可以参考 《C++ Builder 编译 jsoncpp 库 (0.y.z 分支)》

2. 在项目选项里面，添加头文件和库文件的路径

选择菜单 Project -> Options

添加头文件和库文件的路径

头文件的路径需要添加这个文件夹：

头文件的文件夹

库文件的路径需要添加这个文件夹：

库文件的文件夹

3. 包含头文件和链接库文件

#include "json/json.h"

#if defined(__clang__) && (__POINTER_WIDTH__ == 64)
  #pragma link "jsoncpp.a"
#else
  #pragma link "jsoncpp.lib"
#endif

包含头文件，链接库文件

二. 解析 json

由于 jsoncpp 必须采用 UTF-8 编码，所以必须用 UTF8String 字符串类型。

1. 解析 json 字符串

使用 Json::Reader 解析 json 字符串，解析之后放在 Json::Value 里面。

Json::Value 里面存储的可能是一个单个的值，比如整数、浮点数、字符串等，也可能是一组键值对，也可能是数组。

Json::Value v;

如果 v 是 "key" : value 形式的键值对，
Json::Value &value = v["key"]; // 关键字 key 的值

如果 v 是数组
Json::Value &value = v[i]; // 数组第 i 个元素的值

如果要把 Json::Value 储存的单个值读出来，需要用 Json::Value 的成员函数：

函数	得到的值
asBool()	布尔型 bool
asInt()	整型 int
asInt64()	64位整型 long long
asUInt()	无符号整型 unsigned int
asUInt64()	64位无符号整型 unsigned long long
asLargestInt()	最大位数的整型 intmax_t
asLargestUInt()	最大位数的无符号整型 uintmax_t
asFloat()	浮点数 float
asDouble()	双精度浮点数 double
asString()	字符串 std::string
asCString()	字符串 const char *

例：从 Memo 控件里面获取 json 字符串，假定内容如下：

{
    "name" : "JSON 测试程序 - 玄坴",
    "desc" : "Test JSON, Copyright © Hsuanlu",
    "value": 1234.56,
    "故障" :
    [
        { "编码":101, "描述":"故障1" },
        { "编码":102, "描述":"故障2" }
    ]
}

程序代码：

虽然 C++ 11 规定了 u8"这是 UTF-8 字符串" 这样的写法，但是目前的 C++ Builder 编译器还不支持，所以定义了一个 _u8s 在程序里面使用能够简单方便一些：
#define _u8s(s) UTF8String(s).c_str()

#define _u8s(s) UTF8String(s).c_str()
void __fastcall TForm1::Button1Click(TObject *Sender)
{
    try
    {
        UTF8String txt = Memo1->Text; // Memo1 里面的文字转为 UTF-8 编码

        Json::Reader jsReader;
        Json::Value jsValue;
        if(!jsReader.parse(txt.c_str(), jsValue))
        {
            Memo2->Lines->Add(L"JSON 解析错误");
            return;
        }

        UTF8String sVal;
        double lfVal;
        int iVal;

        sVal = jsValue["name"].asCString();
        Memo2->Lines->Add(sVal);

        sVal = jsValue["desc"].asCString();
        Memo2->Lines->Add(sVal);

        lfVal = jsValue["value"].asDouble();
        Memo2->Lines->Add(lfVal);

        for(int i=0; i<2; i++)
        {
            Json::Value &jsFault = jsValue[_u8s(L"故障")][i];
            iVal = jsFault[_u8s(L"编码")].asInt();
            Memo2->Lines->Add(iVal);

            sVal = jsFault[_u8s(L"描述")].asCString();
            Memo2->Lines->Add(sVal);
        }
    }
    catch(std::exception &e)
    {
        UTF8String sErrStr = e.what();
        Memo2->Lines->Add(L"错误：" + sErrStr);
    }
    catch(Exception &e)
    {
        UTF8String sErrStr = e.Message;
        Memo2->Lines->Add(L"错误：" + sErrStr);
    }
}

运行结果：

解析 json 的运行结果

2. 解析 json 文件

只要把文件内容读到 UTF8String 里面就可以用前面的解析 json 字符串的方法解析了。

下面程序把 L"d:\\folder\\filename.txt" 读到 UTF8String txt 里面，按照 BOM 自动识别文件编码 UTF-8 / UNICODE 等，如果没有 BOM 会认为是 ANSI 编码 (由操作系统确定具体编码，Windows 10 新版在控制面板里面可以设为没有 BOM 认为是 UTF-8，否则认为是 ANSI)。

    std::auto_ptrsl(new TStringList);
    sl->LoadFromFile(L"d:\\folder\\filename.txt");
    UTF8String txt = sl->Text;

如果要指定读取的文件是 UTF-8 编码，LoadFromFile 需要加参数 TEncoding::UTF8，如果读取的文件不是 UTF-8 编码，会抛出异常。

    sl->LoadFromFile(L"d:\\folder\\filename.txt", TEncoding::UTF8);

文件读取完成，就可以按照前面第二部分所述的解析 json 字符串的方法了。

三. 生成 json

1. 生成 json 字符串

例：要生成这样的 json：

{
   "data" : 12345,
   "error" : [
      {
         "描述" : "故障1",
         "编码" : "101"
      },
      {
         "描述" : "故障2",
         "编码" : "102"
      }
   ]
}

生成 json 的代码如下，把生成的 json 显示在 Memo2 里面。

void __fastcall TForm1::Button3Click(TObject *Sender)
{
    Json::Value J;
    J["data"] = 12345;
    J["error"][0][UTF8String(L"编码").c_str()] = UTF8String(L"101" ).c_str();
    J["error"][0][UTF8String(L"描述").c_str()] = UTF8String(L"故障1").c_str();
    J["error"][1][UTF8String(L"编码").c_str()] = UTF8String(L"102" ).c_str();
    J["error"][1][UTF8String(L"描述").c_str()] = UTF8String(L"故障2").c_str();

    Memo2->Lines->LineBreak = L"\n"; // jsoncpp 的换行符是 "\n"
    Memo2->Lines->Text = UTF8String(J.toStyledString().c_str());
    Memo2->Lines->LineBreak = L"\r\n"; // 恢复 Windows 的换行符 "\r\n"
}

运行结果：

生成 json 的运行结果

前面的代码是通过 json 根节点直接创建 json 字符串，下面代码是通过中间变量创建：

void __fastcall TForm1::Button4Click(TObject *Sender)
{
    typedef struct
    {
        const wchar_t *sCode;
        const wchar_t *sDesc;
    }   TErrorInfo;

    static const TErrorInfo EInfo[] =
    {
        { L"101", L"故障1" },
        { L"102", L"故障2" },
        { NULL  , NULL     },
    };

    Json::Value J;
    J["data"] = 12345;

    Json::Value &jsError = J["error"];

    for(int i=0; EInfo[i].sCode; i++)
    {
        const TErrorInfo &EI = EInfo[i];
        Json::Value &jsErrInfo = jsError[i];
        jsErrInfo[UTF8String(L"编码").c_str()] = UTF8String(EI.sCode).c_str();
        jsErrInfo[UTF8String(L"描述").c_str()] = UTF8String(EI.sDesc).c_str();
    }

    Memo2->Lines->LineBreak = L"\n"; // jsoncpp 的换行符是 "\n"
    Memo2->Lines->Text = UTF8String(J.toStyledString().c_str());
    Memo2->Lines->LineBreak = L"\r\n"; // 恢复 Windows 的换行符 "\r\n"
}

运行结果：

生成 json 的运行结果

2. 一般格式 toStyledString

用 Json::Value 的 toStyledString() 方法得到的就是一般格式的 json 字符串，如前面例子的效果。

3. 压缩格式 FastWriter

如果生成的 json 字符串用于网络传输，用前面的 toStyledString() 方法得到的字符串有大量的空格和换行符，占用空间太大了，需要用压缩格式的 json 字符串，不包含没有必要的空格和换行符。

void __fastcall TForm1::Button5Click(TObject *Sender)
{
    Json::Value J;
    J["data"] = 12345;
    J["error"][0][UTF8String(L"编码").c_str()] = UTF8String(L"101" ).c_str();
    J["error"][0][UTF8String(L"描述").c_str()] = UTF8String(L"故障1").c_str();
    J["error"][1][UTF8String(L"编码").c_str()] = UTF8String(L"102" ).c_str();
    J["error"][1][UTF8String(L"描述").c_str()] = UTF8String(L"故障2").c_str();

    Memo2->Lines->LineBreak = L"\n"; // jsoncpp 的换行符是 "\n"
    Memo2->Lines->Text = UTF8String(Json::FastWriter().write(J).c_str());
    Memo2->Lines->LineBreak = L"\r\n"; // 恢复 Windows 的换行符 "\r\n"
}

运行结果：

生成压缩格式 json 的运行结果

4. 保存 json 文件

4.1 例：生成一般格式的 UTF-8 编码的 json 文件

void __fastcall TForm1::Button6Click(TObject *Sender)
{
    Json::Value J;
    J["data"] = 12345;
    J["error"][0][UTF8String(L"编码").c_str()] = UTF8String(L"101" ).c_str();
    J["error"][0][UTF8String(L"描述").c_str()] = UTF8String(L"故障1").c_str();
    J["error"][1][UTF8String(L"编码").c_str()] = UTF8String(L"102" ).c_str();
    J["error"][1][UTF8String(L"描述").c_str()] = UTF8String(L"故障2").c_str();

    std::auto_ptrsl(new TStringList);
    sl->LineBreak = L"\n"; // jsoncpp 的换行符是 "\n"
    sl->Text = UTF8String(J.toStyledString().c_str());
    sl->LineBreak = L"\r\n"; // 恢复 Windows 的换行符 "\r\n"
    sl->SaveToFile(L"d:\\test.txt", TEncoding::UTF8);
}

生成的文件用记事本打开查看内容：

生成的 json 文件的内容

4.2 生成压缩格式的 UTF-8 编码的 json 文件

void __fastcall TForm1::Button7Click(TObject *Sender)
{
    Json::Value J;
    J["data"] = 12345;
    J["error"][0][UTF8String(L"编码").c_str()] = UTF8String(L"101" ).c_str();
    J["error"][0][UTF8String(L"描述").c_str()] = UTF8String(L"故障1").c_str();
    J["error"][1][UTF8String(L"编码").c_str()] = UTF8String(L"102" ).c_str();
    J["error"][1][UTF8String(L"描述").c_str()] = UTF8String(L"故障2").c_str();

    std::auto_ptrsl(new TStringList);
    sl->Text = UTF8String(Json::FastWriter().write(J).c_str());
    sl->SaveToFile(L"d:\\test.txt", TEncoding::UTF8);
}

生成的 json 文件用记事本打开查看内容：

生成的 json 文件的内容

四. 下载本文例子源码

请点击：jsoncpp-0.10.7-src-cbuilder 下载 jsoncpp 0.10.7 完整源码、C++ Builder 项目文件、编译好了的库文件、例子程序等。

---

参考：

• C++ Builder 编译 jsoncpp 库 (0.y.z 分支)
• C++ Builder 编译 jsoncpp 库 (master 分支)
• C++ Builder 解析和生成 json (使用 jsoncpp (0.y.z))
• C++ Builder 解析 json，Json::CharReaderBuilder 的使用方法
• C++ Builder 生成 json，Json::StreamWriterBuilder 参数详解
• C++ Builder 遍历 json (使用 jsoncpp)