1、与Writer模块功能相反，可以将Reader理解成一个反序列化的工具，Writer的作用主要是将Value对象转成string或者流式的结构，Reader的作用主要是将流式的结构转成Value类型的对象。Reader类的主要职责有3个，解析 JSON 字符串：将 JSON 格式的字符串读取并解析成相应的 C++ 数据结构。处理不同的数据类型，支持解析 JSON 对象、数组、字符串、数字、布尔值和 null。处理错误，在解析过程中，如果遇到格式错误或不符合 JSON 标准的情况，Reader 类能够捕获这些错误并提供相关的错误信息。示例代码如下：
#include <json/json.h>
#include <iostream>
#include <string>int main() {std::string jsonString = R"({"name": "Alice", "age": 30, "is_student": false})";Json::CharReaderBuilder readerBuilder;Json::Value root;std::istringstream jsonStream(jsonString);std::string errs;// 解析 JSON 字符串if (Json::parseFromStream(readerBuilder, jsonStream, &root, &errs)) {std::cout << "Name: " << root["name"].asString() << std::endl;std::cout << "Age: " << root["age"].asInt() << std::endl;std::cout << "Is Student: " << root["is_student"].asBool() << std::endl;} else {std::cerr << "Error parsing JSON: " << errs << std::endl;}return 0;
}下面这个接口是实际开发中经常会用到的接口，当然我可以也可以向StreamWriterBuilder那样设置解析的属性，这个不难，不再进行介绍，后面会详细介绍下实现解析功能的精髓Token的设计。
bool JSON_API parseFromStream(CharReader::Factory const&, IStream&, Value* root,
String* errs);
2、Token是Reader模块中的精髓，它是jsoncpp 库中用于表示 JSON 数据流中各个组成部分的类。在 JSON 数据解析的过程中，Token 代表了 JSON 字符串中的基本元素，如对象的开始、数组的结束、字符串、数字等。通过对这些标记的处理，jsoncpp 能够逐步解析 JSON 数据并将其转换为 C++ 数据结构。Token的定义如下：
enum TokenType {tokenEndOfStream = 0, //数据流的结束tokenObjectBegin, //对象的开始 {tokenObjectEnd, //对象的结束 }tokenArrayBegin, //数组的开始 [tokenArrayEnd, //数组的结束 ]tokenString, // stringtokenNumber,tokenTrue,tokenFalse,tokenNull,tokenArraySeparator, //数组元素分隔符 ,tokenMemberSeparator, // 对象成员分隔符 ,tokenComment, // 注释tokenError // 解析出错};class Token {public:TokenType type_;Location start_;Location end_;// start_ 表示标记的开始位置，end_ 表示标记的结束位置，识别出TokenType会根据这两个指针去解析对应的数据};
我觉着在解析Object时可以帮助理解Token的作用
bool Reader::readObject(Token& token) {Token tokenName;String name;Value init(objectValue); // 创建一个对象类型的初始值currentValue().swapPayload(init); // 将当前值设置为初始化的对象值currentValue().setOffsetStart(token.start_ - begin_); // 设置对象的起始位置while (readToken(tokenName)) { // 读取下一个标记bool initialTokenOk = true;// 跳过可能存在的注释while (tokenName.type_ == tokenComment && initialTokenOk)initialTokenOk = readToken(tokenName);if (!initialTokenOk)break; // 如果读取注释失败，则退出循环// 如果遇到对象结束标记且没有名称，则表示对象为空if (tokenName.type_ == tokenObjectEnd && name.empty())return true;name.clear(); // 清除之前的名称// 处理对象的成员名称if (tokenName.type_ == tokenString) {if (!decodeString(tokenName, name)) // 解析字符串名称return recoverFromError(tokenObjectEnd); // 解析错误，恢复错误处理} else if (tokenName.type_ == tokenNumber && features_.allowNumericKeys_) {Value numberName;if (!decodeNumber(tokenName, numberName)) // 解析数字名称return recoverFromError(tokenObjectEnd); // 解析错误，恢复错误处理name = numberName.asString(); // 将数字转换为字符串作为名称} else {break; // 如果名称不是字符串或数字，则退出循环}Token colon;// 读取冒号，检查是否存在冒号分隔符if (!readToken(colon) || colon.type_ != tokenMemberSeparator) {return addErrorAndRecover("Missing ':' after object member name", colon, tokenObjectEnd); // 如果缺少冒号，记录错误并恢复}Value& value = currentValue()[name]; // 获取当前值的对应成员nodes_.push(&value); // 将成员值推入栈中bool ok = readValue(); // 读取成员的值nodes_.pop(); // 从栈中弹出成员值if (!ok) // 如果读取值失败，错误已设置return recoverFromError(tokenObjectEnd);Token comma;// 读取逗号或对象结束标记，检查是否存在有效的分隔符if (!readToken(comma) ||(comma.type_ != tokenObjectEnd && comma.type_ != tokenArraySeparator &&comma.type_ != tokenComment)) {return addErrorAndRecover("Missing ',' or '}' in object declaration", comma, tokenObjectEnd); // 如果缺少逗号或结束标记，记录错误并恢复}bool finalizeTokenOk = true;// 跳过可能存在的注释while (comma.type_ == tokenComment && finalizeTokenOk)finalizeTokenOk = readToken(comma);if (comma.type_ == tokenObjectEnd)return true; // 如果遇到对象结束标记，则成功解析对象并返回}return addErrorAndRecover("Missing '}' or object member name", tokenName, tokenObjectEnd); // 如果缺少对象结束标记或成员名称，记录错误并恢复
}
