jsoncpp使用指南与技巧

一、jsoncpp概述

jsoncpp是一个高效的C++库，专门用于处理JSON数据的序列化和反序列化。它广泛应用于各种需要与JSON数据交互的应用场景中。

开源地址: https://github.com/open-source-parsers/jsoncpp

文档地址: http://open-source-parsers.github.io/jsoncpp-docs/doxygen/index.html

二、jsoncpp的基本使用

jsoncpp库主要通过三个核心类——Value、Reader和Writer来操作JSON数据。其中，Value类用于表示JSON对象或数组，Reader类负责从字符串中解析JSON数据，而Writer类则用于将JSON数据转换成字符串形式。

示例1：创建JSON数据

Json::Value root; // 创建根节点
Json::Value item; // 创建子节点
item["item1"] = "one"; // 添加字符串类型的数据
item["item2"] = 2; // 添加整型数据
root.append(item); // 将子节点添加到根节点的数组中
item.clear(); // 清空item
item["item1.0"] = 1.0; // 添加浮点型数据
item["item2.0"] = 2.0;
root["item"] = item; // 将item作为根节点的一个成员
std::string jsOnString= root.toStyledString(); // 转换为格式化的JSON字符串

示例2：解析JSON数据

Json::Reader reader;
std::string jsOnStr= "{\"age\": 123, \"name\": \"weng\"}";
Json::Value jsonObj;
if (!reader.parse(jsonStr, jsonObj)) {
    std::cout <<"解析失败" <} else {
    std::cout <<"年龄: " <}

示例3：处理空数组

Json::Value root;
root["FaceItemObjects"].resize(0); // 创建一个空的数组
std::string jsOnString= root.toStyledString();

示例4：构建复杂的JSON结构

Json::Value root;
Json::Value faceArray;
Json::Value face;
root["errorCode"] = 0;
root["faces"].resize(0); // 初始化faces为空数组
// 添加第一个face
face["x"] = 1;
face["y"] = 1;
face["width"] = 100;
face["height"] = 100;
face["score"] = 95;
faceArray.append(face);
// 添加第二个face
face.clear();
face["x"] = 200;
face["y"] = 200;
face["width"] = 100;
face["height"] = 100;
face["score"] = 98;
faceArray.append(face);
root["faces"] = faceArray;
std::string jsOnString= root.toStyledString();

三、使用jsoncpp时的注意事项

1. **64位整数的支持**：早期版本的jsoncpp可能不支持64位整数。建议使用0.6.0rc2及以上版本，或者在项目中定义JSON_HAS_INT64宏以启用64位整数支持。

2. **访问不存在的键**：尝试访问JSON对象中不存在的键会导致程序崩溃。可以通过检查键是否存在来避免这种情况，例如使用isMember()方法。

3. **中文字符的处理**：默认情况下，jsoncpp可能会将中文字符编码为Unicode转义序列（如\uXXXX）。如果需要直接输出中文字符，可以在序列化时设置相应的选项，或者使用第三方库进行转换。

4. **编译错误**：遇到类似“无法打开编译器生成的文件”的错误时，通常是由于编译器设置不当引起的。可以通过调整项目的编译设置，如关闭汇编输出，来解决此类问题。

5. **异常处理**：在解析JSON数据时，应考虑使用异常处理机制来捕获可能的解析错误，确保程序的健壮性。

bool parseSuccess = false;
try {
    Json::Reader reader;
    std::string jsOnStr= "{\"age\": 123, \"name\": \"weng\"}";
    Json::Value jsonObj;
    if (!reader.parse(jsonStr, jsonObj)) {
        std::cout <<"解析失败" <        parseSuccess = false;
    } else {
        std::cout <<"年龄: " <        parseSuccess = true;
    }
} catch (...) {
    parseSuccess = false;
}