JsonCpp源码分析——Writer

1、Writer 类是 jsoncpp 中用于将 JSON 数据转换为字符串的关键组件。这个类的设计使得从 Json::Value 对象生成 JSON 字符串变得简单而高效。Writer 类的主要任务是将内存中的 JSON 数据结构转化为符合 JSON 标准的字符串格式，以便可以进行存储、传输或与其他系统交互，其实就是一个序列化的工具。
2、Writer 类的核心功能是将 JSON 数据结构（如对象、数组、字符串和数字）序列化为 JSON 格式的字符串。它支持将 Json::Value 对象转换为 JSON 字符串，这些对象可以包含复杂的嵌套数据结构。

#include <iostream>
#include <json/json.h>

int main() {
    // 创建一个 JSON 对象
    Json::Value root;
    root["name"] = "Alice";
    root["age"] = 28;
    root["is_student"] = false;

    // 创建一个 JSON 数组
    Json::Value hobbies(Json::arrayValue);
    hobbies.append("Cycling");
    hobbies.append("Photography");
    root["hobbies"] = hobbies;

    // 使用 Writer 类将 JSON 对象转换为字符串
    Json::StreamWriterBuilder writerBuilder;
    std::string jsonString = Json::writeString(writerBuilder, root);

    // 输出生成的 JSON 字符串
    std::cout << jsonString << std::endl;

    return 0;
}

在上面的示例中，我们创建了一个包含基本数据类型和数组的 JSON 对象，并使用 Json::StreamWriterBuilder 将其转换为 JSON 字符串。
3、StyledWriter是Writer的子类，其主要功能是将 JSON 数据结构转化为美观的 JSON 字符串。它在 JSON 字符串中添加缩进和换行，以提高可读性，可以理解为输出的字符串中包含\n和空行。
4、StreamWriterBuilder 提供了多种配置选项，可以控制 JSON 输出的格式。通过设置缩进、空白字符等选项，可以生成易于阅读和调试的 JSON 字符串，默认的配置如下，可以自行配置。

void StreamWriterBuilder::setDefaults(Json::Value* settings) {
  //"All" 表示保留所有类型的注释。注释风格的选项可能包括 "None"（不允许注释）、"All"（允许所有类型的注释）、"Cpp"（仅允许 C++ 风格的注释）
  (*settings)["commentStyle"] = "All";
  // \t 表示使用制表符作为缩进字符。可以用空格替代制表符，例如 " "（四个空格）
  (*settings)["indentation"] = "\t";
  // 如果为 true，生成的 JSON 字符串将遵循 YAML 兼容的格式，允许 YAML 特性，如支持特殊字符的转义
  (*settings)["enableYAMLCompatibility"] = false;
  // 指定是否省略值为 null 的字段。如果为 true，则不会在输出的 JSON 字符串中包含值为 null 的字段
  (*settings)["dropNullPlaceholders"] = false;
  (*settings)["useSpecialFloats"] = false;
  // 默认不支持utf8， true为支持utf8
  (*settings)["emitUTF8"] = false;
  (*settings)["precision"] = 17;
  (*settings)["precisionType"] = "significant";
}

使用StreamWriterBuilder进行格式化：

#include <json/json.h>
#include <iostream>

int main() {
    // 创建一个 JSON 对象
    Json::Value root;
    root["name"] = "Alice";
    root["age"] = 28;
    root["is_student"] = false;

    // 创建一个 JSON 数组
    Json::Value hobbies(Json::arrayValue);
    hobbies.append("Cycling");
    hobbies.append("Photography");
    root["hobbies"] = hobbies;

    // 创建 StreamWriterBuilder 对象
    Json::StreamWriterBuilder writerBuilder;
    
    // 配置输出选项
    writerBuilder["indentation"] = "    "; // 设置四个空格的缩进

    // 将 JSON 对象转换为字符串
    std::string jsonString = Json::writeString(writerBuilder, root);

    // 输出生成的 JSON 字符串
    std::cout << jsonString << std::endl;

    return 0;
}