引言
Jsoncpp 库主要是用于实现 Json 格式数据的序列化和反序列化,它实现了将多个数据对象组织成 为Json格式字符串,以及将 Json 格式字符串解析得到多个数据对象的功能,独立于开发语言。
Json数据对象
Json数据对象类的表示:
class Json::Value{Value &operator=(const Value &other); //Value重载了[]和=,因此所有的赋值和获取数据都可以通过 Value& operator[](const std::string& key);//简单的⽅式完成 val["name"] = "xx";Value& operator[](const char* key);Value removeMember(const char* key);//移除元素 const Value& operator[](ArrayIndex index) const; //val["score"][0]Value& append(const Value& value);//添加数组元素val["score"].append(88); ArrayIndex size() const;//获取数组元素个数 val["score"].size(); std::string asString() const;//转string string name = val["name"].asString();const char* asCString() const;//转char* char *name = val["name"].asCString();Int asInt() const;//转int int age = val["age"].asInt(); float asFloat() const;//转float float weight = val["weight"].asFloat(); bool asBool() const;//转 bool bool ok = val["ok"].asBool();
};
上面列举了Json数据对象Json::Value的一些成员方法, Json::Value是用来存储数据的,可以把它理解为一个容器。序列化方法和反序列化方法就可以将传入的Json::Value数据对象进行序列化和反序列化操作。
Json基本语法规则
Json通常采用KeyValue的格式。例如:“姓名”:“小颖”,中间用冒号:隔开。其中,键名必须为字符串且必须用双引号包裹。
{ "key": "value" } // ✅ 正确
{ key: "value" } // ❌ 错误
Json中还有另一种数据结构——数组。用中括号[ ]包裹起来,里面的值的类型可以不同。
["苹果", "香蕉", 123, true]
序列化接口
class JSON_API StreamWriter {virtual int write(Value const& root, std::ostream* sout) = 0;//......
}
class JSON_API StreamWriterBuilder : public StreamWriter::Factory {virtual StreamWriter* newStreamWriter() const;//......
}
可以看得出来,这里用到了一种设计模式——工厂模式。 也就是说使用StreamWriterBuilder 来生产StreamWriter对象。write就是序列化接口,第一个参数为存储数据的Value对象,第二个参数为输出流对象的指针。StreamWriter用于将JSON数据写入到输出流中,StreamWriterBuilder
则是用来配置和创建StreamWriter
实例的。所谓配置,就是配置Json输出的格式,比如缩进、换行这些都是。下面用代码演示如何对数据进行序列化。
反序列化接口
class JSON_API CharReader {virtual bool parse(char const* beginDoc, char const* endDoc, Value* root, std::string* errs) = 0;
}
class JSON_API CharReaderBuilder : public CharReader::Factory {virtual CharReader* newCharReader() const;
}
和序列化一样,这里同样用到了工厂设计模式。CharReaderBuilder 负责配置解析规则,然后由CharReader来进行解析。CharReader不能直接创建对象,因为它里面有个纯虚函数,所以它是个抽象类。创建对象的职责由CharReaderBuilder来承担。函数parse就是用来完成反序列化的。
序列化和反序列化代码演示
#include <iostream>
#include <memory>
#include <sstream>
#include <jsoncpp/json/json.h>//序列化
bool Serialize(const Json::Value val, std::string &body)
{std::stringstream ss;//构建StreamWriter对象Json::StreamWriterBuilder swb;std::unique_ptr<Json::StreamWriter> sw(swb.newStreamWriter());int ret = sw->write(val, &ss);//成功返回0,失败返回-1if(ret != 0){std::cout << "serialize faild\n";return false;}body = ss.str();return true;
}//反序列化
bool unserialize(const std::string &body, Json::Value&val)
{Json::CharReaderBuilder crb;std::unique_ptr<Json::CharReader> cr(crb.newCharReader());std::string errs;bool ret = cr->parse(body.c_str(), body.c_str() + body.size(), &val, &errs);if(ret == false){std::cout << "unserialize faild : " << errs << std::endl;return false;}return true;
}int main()
{Json::Value stu;stu["姓名"] = "小颖";stu["年龄"] = 19;//构建数组,不能直接stu["爱好"] = ["打羽毛球", "吃吃吃", "散步"];stu["爱好"].append("打羽毛球");stu["爱好"].append("吃吃吃");stu["爱好"].append("散步");std::string body;Serialize(stu, body);std::cout << body << std::endl;std::string str = R"({"姓名":"小北", "年龄":20})";//C++11的一种新语法,定义一个字符串Json::Value student;bool ret = unserialize(str, student);//将字符串反序列化if(ret == false)return -1;std::cout << "姓名:" << student["姓名"].asString() << std::endl;std::cout << "年龄:" << student["年龄"].asInt() << std::endl;return 0;
}//运行结果
{"\u59d3\u540d" : "\u5c0f\u9896","\u5e74\u9f84" : 19,"\u7231\u597d" : ["\u6253\u7fbd\u6bdb\u7403","\u5403\u5403\u5403","\u6563\u6b65"]
}
姓名:小北
年龄:20