目录
一、前言
二、深度解析序列化和反序列化
?引入序列化和反序列化?
?什么是序列化(Serialization)??
?什么是反序列化(Serialization)??
? 序列化和反序列化的应用场景?
?常见的序列化格式?
三、JSON的介绍与使用
?JSON的数据格式?
?Jsoncpp库的介绍?
①:Json::Value 类 ----- 中间数据存储类
②:Json::StreamWriter 类 ----- 用于数据序列化
③:Json::CharReader 类 ----- 用于数据反序列化
?Json实战应用?
?Json序列化
?Json反序列化
四、总结
五、共勉
一、前言
在现代软件开发中,JSON(JavaScript Object Notation)已经成为数据交换的标准格式之一。无论是在前后端通信、API 数据传输,还是在配置文件管理中,JSON 的简洁性和可读性使其广泛应用。然而,处理 JSON 数据的关键在于序列化和反序列化——将数据结构转换为 JSON 格式,以及将 JSON 格式解析回数据结构。这篇博客将深入探讨 JSON 序列化和反序列化的概念,并通过实例展示如何在 C++ 中高效地处理 JSON 数据。
二、深度解析序列化和反序列化
?引入序列化和反序列化?
生活中的类比:打包和解包
假设你要寄送一个复杂的玩具给朋友,但这个玩具有很多零件和组件,直接寄送会很麻烦,容易丢失零件,也不方便运输。为了方便,你决定把玩具拆解开来,打包成一个扁平的小盒子,方便运输。序列化:
你把玩具拆解开来,把所有的零件和组件按照一定的顺序放入一个盒子里,并标记好每个零件的位置。这相当于把复杂的对象转化为一个易于存储和传输的格式。反序列化:
朋友收到包裹后,根据你的标记把零件重新组装成原来的玩具。这相当于将线性数据转换回原本的对象。?什么是序列化(Serialization)??
序列化是将 数据结构 或 对象 转换成一种可以存储或传输的格式的过程。简单来说,就是把复杂的数据变成一个“线性”的形式(如字符串、二进制数据),这样就可以方便地存储到文件、数据库,或通过网络传输。
?什么是反序列化(Serialization)??
反序列化是序列化的逆过程,它将存储或传输的数据格式转换回原本的数据结构或对象。也就是说,通过反序列化,可以从存储或传输的“线性”数据中恢复出原本的对象或数据结构。
? 序列化和反序列化的应用场景?
数据存储:
在数据库中存储对象时,可以先将对象序列化成一个可以存储的格式(如JSON或二进制),存储后再需要时通过反序列化恢复成对象。网络传输: (常用)
在网络通信中,常常需要将对象序列化为字符串或二进制数据,通过网络传输到另一端,然后通过反序列化恢复成对象。文件存储:
例如保存游戏状态时,可以将游戏对象序列化成文件,之后读取文件时再反序列化恢复游戏状态。?常见的序列化格式?
JSON(JavaScript Object Notation):通常存储在 Jsoncpp库中
一种基于文本的轻量级数据交换格式,易于阅读和编写。XML(eXtensible Markup Language):
也是一种基于文本的数据交换格式,广泛用于配置文件和数据交换。二进制格式:
某些应用程序会使用二进制格式进行序列化,因为它更紧凑,效率更高。三、JSON的介绍与使用
JSON(JavaScript Object Notation)是一种轻量级的数据交换格式,广泛应用于数据存储和 网络通信中。为了在C++中处理JSON数据,通常使用一些第三方库,如 JsonCpp 库
。
?JSON的数据格式?
Json 是⼀种数据交换格式,它采⽤完全独⽴于编程语⾔的⽂本格式来存储和表⽰数据。
例如 : 我们想表⽰⼀个同学的学⽣信息
C语言代码表示:char* name = "xax";int age = 18;float score[3] = {88.5 , 99 , 58};
Json代码表示: { "姓名" :"xas", "年龄" : "18", "成绩" : "[88.5 , 99 , 58]", "爱好" : { "书籍" : "我与地坛", "运动" : "打乒乓球" }}
从上面的代码可以发现 Json 的数据类型包括 对象,数组,字符串,数字等。
对象 :使用花括号 { } 括起来的表示一个对象数组 :使用中括号 [ ] 括起来的表示一个数组字符串 :使用常规双引号 " " 括起来的表示一个字符串数字 :包括整形和浮点型,直接使用同时我们还可以发现一些 Json的语法规则
键值对格式: { key : value}
JSON 是由一组键值对组成的,每个键值对都以"键": "值"
的形式表示。键和值之间用冒号 :
分隔。 键(key)必须是字符串 :
JSON 的键必须是用双引号""
包围的字符串。在示例中,"姓名"
, "年龄"
, "成绩"
和 "爱好"
都是字符串形式的键。 值(value)可以是多种类型 :
字符串:例如"xas"
, "我与地坛"
。数字:例如 18
, 88.5
, 99
, 58
(尽管在示例中这些数字被当作字符串)。布尔值:例如 true
, false
(在此例中未使用)。数组:例如 "[88.5, 99, 58]"
,表示一个由多个值组成的有序列表。对象:例如 "爱好"
对应的值 { "书籍": "我与地坛", "运动": "打乒乓球" }
,表示另一个嵌套的键值对集合。null:表示空值(在此例中未使用)。 嵌套结构
JSON 可以包含嵌套的对象,即对象内的键值对中,值可以是另一个对象。例如,"爱好"
对应的值是一个嵌套的 JSON 对象。 逗号分隔
在对象中,键值对之间用逗号,
分隔。在数组中,元素之间也用逗号 ,
分隔。 ?Jsoncpp库的介绍?
在 C++ 中处理 JSON 数据时,需要了解 JSON 对象(Json::Value
)以及相关的函数非常重要。我会以 JsonCpp
这个库为例,详细讲解它们中的常用函数和对象,以及如何使用。
①:Json::Value 类 ----- 中间数据存储类
如果要将数据对象进行序列化,就需要先存储到 Json::Value对象中,组织数据与数据之间的关系如果要将数据对象进行反序列化,就是将数据解析后,将数据的对象放入到 Json::Value中创建和初始化
Json::Value jsonObj; // 创建一个空的 JSON 对象// 直接赋值初始化jsonObj["name"] = "Alice";jsonObj["age"] = 30;jsonObj["is_student"] = false;// 数组初始化Json::Value grades(Json::arrayValue); // 创建一个 JSON 数组grades.append(85);grades.append(90);grades.append(92);jsonObj["grades"] = grades;
访问数据
std::string name = jsonObj["name"].asString(); // 获取字符串int age = jsonObj["age"].asInt(); // 获取整数bool isStudent = jsonObj["is_student"].asBool(); // 获取布尔值
修改数据
jsonObj["age"] = 31; // 修改键对应的值jsonObj["grades"].append(95); // 向数组中添加新元素
删除键值对
jsonObj.removeMember("is_student"); // 删除键为 "is_student" 的键值对
遍历对象
for (Json::Value::const_iterator it = jsonObj.begin(); it != jsonObj.end(); ++it) { std::cout << it.key().asString() << " : " << *it << std::endl;}
②:Json::StreamWriter 类 ----- 用于数据序列化
Json::StreamWriter
用于将 JSON 对象序列化(转换为文本形式)并写入到输出流(例如文件流或标准输出)。
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;}
StreamWriter::write
Json::Value
对象写入指定的输出流。参数: const Json::Value &root
:要写入的 JSON 对象。std::ostream *sout
:输出流指针,表示数据将写入的目标位置。返回值:返回一个 int
,通常表示写入的数据量。 Json::Value root;root["name"] = "Alice";root["age"] = 25;Json::StreamWriterBuilder writer;std::unique_ptr<Json::StreamWriter> jsonWriter(writer.newStreamWriter());jsonWriter->write(root, &std::cout);std::cout << std::endl;
StreamWriterBuilder
StreamWriter
对象的辅助类。提供了一些选项,可以自定义输出格式(如缩进和格式化)。 ③:Json::CharReader 类 ----- 用于数据反序列化
Json::CharReader
用于从输入流中读取 JSON 数据并将其解析为 Json::Value
对象。
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;}
CharReader::parse
Json::Value
对象。参数: const char *beginDoc
:指向要解析的 JSON 文档的起始位置。const char *endDoc
:指向 JSON 文档的结束位置(通常是 beginDoc + length
)。Json::Value *root
:指向将保存解析结果的 Json::Value
对象。Json::String &errs
:用于存储任何解析过程中发生的错误信息。返回值:返回 bool
,如果解析成功,返回 true
,否则返回 false
。 std::string rawJson = R"({"name": "Alice", "age": 25})";Json::CharReaderBuilder reader;Json::Value root;std::string errs;std::unique_ptr<Json::CharReader> jsonReader(reader.newCharReader());bool parsingSuccessful = jsonReader->parse(rawJson.c_str(), rawJson.c_str() + rawJson.size(), &root, &errs);if (parsingSuccessful) { std::cout << root["name"].asString() << std::endl; // 输出 "Alice"} else { std::cerr << "Failed to parse JSON: " << errs << std::endl;}
CharReaderBuilder
CharReader
对象的辅助类。通过配置,可以自定义解析器的行为。 ?Json实战应用?
在实战应用前,我的介绍一下我们的实验环境:
在 Linux(Ubuntu ) 服务器上进行实验 ,使用C++代码由于Jsoncpp库是一个第三方库,我们需要自己手动安装
sudo apt-get install -y libjsoncpp-dev
安装好后,进行检查是否安装成功 ?Json序列化
把复杂的对象转化为一个易于存储和传输的格式。
#include <iostream>#include <string>#include <vector>#include <memory>#include <jsoncpp/json/json.h>#include <sstream>// 实现数据的序列化bool Hierarch(const Json::Value &val , std::string &body){ std::stringstream ss; // 进行序列化 // 因为 StreamWriter 它的基类是一个抽象类,有纯虚函数存在,不能进行实例化 // 所以通过工厂类 StreamWriterBuilder 来产生派生类对象 Json::StreamWriterBuilder swb; // 父类对象指向子类对象 // 注意 sw 是一个 new 出来的一个对象,需要去释放它 --- 采用智能指针 std::unique_ptr<Json::StreamWriter> sw(swb.newStreamWriter()); //实例化结束 int ret = sw->write(val , &ss); // 这里序列化成功,会返回一个 0 if(ret!=0) { std::cout<<"Json Hierarch failed!\n"; return false; } body = ss.str(); return true;}int main(){ const char* name = "xas"; int age = 18; const char* sex = "男"; float score[3] = {88 , 77.5 , 66}; // 进行数据传输 Json::Value student; student["姓名"] = name; student["年龄"] = age; student["性别"] = sex; student["成绩"].append(score[0]); student["成绩"].append(score[1]); student["成绩"].append(score[2]); Json::Value fav; fav["书籍"] = "我与地坛"; fav["运动"] = "打乒乓球"; student["爱好"] = fav; std::string body; Hierarch(student , body); std::cout<<body<<std::endl; return 0;}
?Json反序列化
将线性数据转换回原本的对象。
#include <iostream>#include <string>#include <vector>#include <memory>#include <jsoncpp/json/json.h>#include <sstream>// 实现数据的序列化 --- 将原本的对象,转换为 Json::Value 格式存储bool Hierarch(const Json::Value &val , std::string &body){ std::stringstream ss; // 进行序列化 // 因为 StreamWriter 它的基类是一个抽象类,有纯虚函数存在,不能进行实例化 // 所以通过工厂类 StreamWriterBuilder 来产生派生类对象 Json::StreamWriterBuilder swb; // 父类对象指向子类对象 // 注意 sw 是一个 new 出来的一个对象,需要去释放它 --- 采用智能指针 std::unique_ptr<Json::StreamWriter> sw(swb.newStreamWriter()); //实例化结束 int ret = sw->write(val , &ss); // 这里序列化成功,会返回一个 0 if(ret!=0) { std::cout<<"Json Hierarch failed!\n"; return false; } body = ss.str(); return true;}// 反序列化 -- 将 Json::Value 对象 转换成 原本的数据 bool UnHierarch( const std::string &body , Json::Value &val){ // 因为 CharReader 它的基类是一个抽象类,有纯虚函数存在,不能进行实例化 // 所以通过工厂类 CharReaderBuilder 来产生派生类对象 Json::CharReaderBuilder crb; // 父类对象指向子类对象 // 注意 cr 是一个 new 出来的一个对象,需要去释放它 --- 采用智能指针 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<<"Json UnHierarch failed\n"; return false; } return true;}int main(){ const char* name = "xas"; int age = 18; const char* sex = "男"; float score[3] = {88 , 77.5 , 66}; // 进行数据传输 Json::Value student; student["姓名"] = name; student["年龄"] = age; student["性别"] = sex; student["成绩"].append(score[0]); student["成绩"].append(score[1]); student["成绩"].append(score[2]); Json::Value fav; fav["书籍"] = "我与地坛"; fav["运动"] = "打乒乓球"; student["爱好"] = fav; std::string body; Hierarch(student , body); std::cout<<body<<std::endl; std::string str = R"({"姓名" : "WD" , "年龄" : 19 , "成绩" : [32,45.5,56]})"; Json::Value stu; bool ret = UnHierarch(str , stu); if(ret == false) { return -1; // 退出 } std::cout<<"姓名: "<<stu["姓名"].asString()<<std::endl; std::cout<<"年龄: "<<stu["年龄"].asInt()<<std::endl; int sz = stu["成绩"].size(); for(int i = 0;i < sz ; i++) { std::cout<<"成绩: "<<stu["成绩"][i].asFloat()<<std::endl; } return 0;}
四、总结
在 C++ 项目中,使用 JSON 格式进行数据交换是非常常见的。为了实现 JSON 数据的序列化(将数据结构转换为 JSON 字符串)和反序列化(将 JSON 字符串解析为数据结构),我们可以使用 JsonCpp 库中的 Json::StreamWriter
和 Json::CharReader
类。
序列化
序列化过程将数据结构转换为 JSON 字符串,以便在网络上传输或存储。Json::StreamWriterBuilder
是一个工厂类,它帮助我们创建 StreamWriter
对象用于生成 JSON 字符串。通过智能指针来管理 StreamWriter
对象,可以确保在使用完毕后自动释放资源。 反序列化
反序列化过程则是将 JSON 字符串解析回数据结构。类似地,Json::CharReaderBuilder
用于生成 CharReader
对象来处理解析操作。通过智能指针管理 CharReader
对象,可以避免手动释放内存的麻烦。 在实际应用中,确保数据类型的一致性非常重要。例如,在反序列化时,如果试图将一个字符串转换为整数,程序将抛出异常。因此,在进行类型转换前,检查 JSON 数据的类型是避免错误的关键。
五、共勉
以下就是我对 【C++】Json序列化和反序列化 的理解,如果有不懂和发现问题的小伙伴,请在评论区说出来哦,同时我还会继续更新对 【C++11】 的理解,请持续关注我哦!!!