FdogSerialize是一个用于C++序列化和反序列化快速互转开源库，采用非入侵方式，无需在原有结构体上进行修改，即可完成转换，目前支持基础类型，基础类型数组，结构体，以及vector，list，map等数据类型的序列化，支持JSON和XML两种数据格式，支持别名，支持忽略字段，最少三行代码即可完成转换使得它足够方便，欢迎体验，如果对您有帮助，不妨给我一个star！
经常使用java或者go的人应该知道这些语言在进行序列化和反序列化是很容易的，但是对于C++而言，这是困难的，根本原因是C++不支持反射，基于c++的语言哲学，C++宁死也要坚守的zero overhead，不为用不到的特性付出任何代价，不管这个代价有多小，也不管是怎样的语言特性，都不会妥协。
虽然C++不支持反射，但是我们依旧可以通过自己的方式实现序列化与反序列化，记得我在大二时用C++写的一个client-server小项目，自己规定了传输的数据格式（当时觉得自己解析Json很麻烦），第一个字段应该是什么，第二个字段应该是什么，正是因为没有方便的函数进行转换，我每次都需要使用非常繁琐的代码去拼出一个可以传递的字符串，是的，这样确实可以完成我想要的功能，但是我自己定的数据格式只适合自己用，这种方式长期必然行不通，而大多数人使用JSON和XML这两种数据格式来保存对象，如果我的项目想要使用这种大众化的数据格式，我又将重构我的代码。
我试着在github寻找一些用于C++的序列化与反序列的库，看看有没有什么办法可以帮助我快速把对象转变成JSON，我找到了一些类似的库，但是有一些设计不太合我心意。
不太和我心意的设计：
- 使用者需要添加过多代码
- 采用入侵方式，需要改变原有的结构体
-
不需要入侵，但是在注册的时候需要一个一个指定类型
-
只支持基础类型组成的结构体转换
- 不支持别名（由于go的特性，在go中经常被使用）
- 不支持忽略字段
- 不支持指针类型（如果原项目中存在指针类型便需要指针类型）
既然心高气傲都不满意，那就自己动手写一个吧，一开始想简单的了，说实话后面还是有些难度的，虽然说C++中应该尽可能的少用宏，但就目前来说C++没有反射机制，编译后不保存结构体的元信息来说，不得不使用大量的宏。
暂时将这个库分为下面几个阶段：
- 支持由基础类型和Json互转【完成】
- 支持由基础类型组成的数组和json互转【完成】
- 支持由基础类型组合成结构体类型和Json互转【完成】
- 支持由结构体包含结构体的类型和Json互转【完成】
- 支持vector类型和json互转【完成】
- 支持list类型和json互转【完成】
- 支持map类型和json互转【完成】
- 支持set类型和json互转【完成】
- 支持STL和自定义类型多层嵌套【完成】
- 支持XML数据格式【未完成】
杂项支持：
- 支持别名【完成】
- 支持字段忽略【未完成】
- 支持忽略大小写【未完成】
暂时就想到怎么多，欢迎补充！
| 序号 | 基础类型 | 说明 | 序号 | 基础类型 | 说明 |
|---|---|---|---|---|---|
| 1 | bool | 布尔类型 | 9 | unsigned int | 无符号整型 |
| 2 | char | 无符号字符型 | 10 | long | 长整型 |
| 3 | unsigned char | 无符号字符型 | 11 | unsigned long | 无符号长整型 |
| 4 | **char *** | 字符指针（字符串类型） | 12 | long long | 超长整型 |
| 5 | short | 短整型 | 13 | unsigned long long | 无符号超长整型 |
| 6 | unsigned short | 无符号短整型 | 14 | float | 单精度浮点类型 |
| 7 | int | 整型 | 15 | double | 双进度浮点类型 |
| 8 | unsigned int | 无符号整型 | 16 | long double | 长双进度浮点类型 |
基于C++的基础类型，FdogSerialize支持如上的十六种类型，只要你的结构体中最基本类型在这十六种范围之内，便可完成转换。
最基本类型说明：
struct headmaster{
char * name;
int age;
};
struct school{
char * schoolName;
headmaster info;
};虽然school这个结构体包含了一种最基础类型和一种自定义类型，但追寻本质，自定义类型的底层都属于最基本类型。
因此school这个结构体完全可以被正常解析，事实上是任意类型都可以解析。
#include "macrodefinition.h" //添加序列化所需头文件
int main()
{
int value = 10;
string json_;
//将value转为json格式数据，建议使用第二种类型
FdogSerialize::Instance()->FSerialize(json_, value); //json值为 "{10}"
FdogSerialize::Instance()->FSerialize(json_, value, "value"); //json值为"{"value":10}"
//将json格式数据转为value 需保证json_为正确格式字符串
FdogSerialize::Instance()->FDesSerialize(value, json_);
return 0;
}#include "macrodefinition.h" //添加序列化所需头文件
int main()
{
int valueArray[5] = {1,2,3,4,5};
string json_;
//将valueArray转为json格式数据，建议使用第二种类型
FdogSerialize::Instance()->FSerialize(json_, value); //json值为 "{[1,2,3,4,5]}"
FdogSerialize::Instance()->FSerialize(json_, value, "value"); //json值为"{"valueArray":[1,2,3,4,5]}"
//将json格式数据转为value 需保证json_为正确格式字符串
FdogSerialize::Instance()->FDesSerialize(value, json_);
}#include "macrodefinition.h" //添加序列化所需头文件
//自定义基础类型结构体
struct student{
char * name;
int age;
};
int main()
{
REGISTEREDMEMBER(student, name, age); //需要注册自定义类型，第一个参数为自定义结构体名，后面参数依次为成员名
struct stu;
stu.name = "花狗Fdog";
stu.age = 22;
string json_;
//将value转为json格式数据
FdogSerialize::Instance()->FSerialize(json_, value, "stu"); //json值为"{"stu":{"name":"花狗Fdog","age":22}}"
//将json格式数据转为value 需保证json_为正确格式字符串
FdogSerialize::Instance()->FDesSerialize(value, json_);
}#include "macrodefinition.h" //添加序列化所需头文件
//自定义基础类型结构体
struct student{
char * name;
int age;
};
struct school{
char * schoolName;
student stu;
};
//需要在宏Serialize_type_judgment_all定义下添加嵌套结构体
#define Serialize_type_judgment_all\
Serialize_type_judgment(student)
//依次添加
//需要在宏Serialize_type_judgment_all定义下添加嵌套结构体
#define DesSerialize_type_judgment_all\
DesSerialize_type_judgment(student)
//依次添加
int main()
{
REGISTEREDMEMBER(student, name, age); //需要注册自定义类型
REGISTEREDMEMBER(school, school, stu); //需要注册自定义类型
school sch;
sch.schoolName = "fzyz";
sch.stu.name = "花狗Fdog";
sch.stu.age = 22;
string json_;
//将value转为json格式数据
FdogSerialize::Instance()->FSerialize(json_, value, "sch");
//json值为"{"sch":{"schoolName":"fzyz","stu":{"name":"花狗Fdog","age":21}}}"
//将json格式数据转为value 需保证json_为正确格式字符串
FdogSerialize::Instance()->FDesSerialize(value, json_);
}#include "macrodefinition.h" //添加序列化所需头文件
//自定义基础类型结构体
struct student{
char * name;
int age;
};
//需要在宏Serialize_type_judgment_all定义下添加嵌套结构体
#define Serialize_type_judgment_all\
Serialize_type_judgment(student)
//依次添加
//需要在宏Serialize_type_judgment_all定义下添加嵌套结构体
#define DesSerialize_type_judgment_all\
DesSerialize_type_judgment(student)
//依次添加
int main()
{
REGISTEREDMEMBER(student, name, age); //需要注册自定义类型，第一个参数为自定义结构体名，后面参数依次为成员名
vector<student> stu;
struct stu_1;
stu_1.name = "花狗Fdog";
stu_1.age = 22;
struct stu_2;
stu_2.name = "黑狗Fdog";
stu_2.age = 23;
stu.push_back(stu_1);
stu.push_back(stu_2);
string json_;
//将value转为json格式数据
FdogSerialize::Instance()->FSerializeV(json_, stu, "stu");
//json值为"{"stu":[{"name":"花狗Fdog","age":22},{"name":"黑狗Fdog","age":23}]}"
//将json格式数据转为value 需保证json_为正确格式字符串
FdogSerialize::Instance()->FDesSerializeV(value, json_);
}#include "macrodefinition.h" //添加序列化所需头文件
//自定义基础类型结构体
struct student{
char * name;
int age;
};
//需要在宏Serialize_type_judgment_all定义下添加嵌套结构体
#define Serialize_type_judgment_all\
Serialize_type_judgment(student)
//依次添加
//需要在宏Serialize_type_judgment_all定义下添加嵌套结构体
#define DesSerialize_type_judgment_all\
DesSerialize_type_judgment(student)
//依次添加
int main()
{
REGISTEREDMEMBER(student, name, age); //需要注册自定义类型，第一个参数为自定义结构体名，后面参数依次为成员名
list<student> stu;
struct stu_1;
stu_1.name = "花狗Fdog";
stu_1.age = 22;
struct stu_2;
stu_2.name = "黑狗Fdog";
stu_2.age = 23;
stu.push_back(stu_1);
stu.push_back(stu_2);
string json_;
//将value转为json格式数据
FdogSerialize::Instance()->FSerializeL(json_, stu, "stu");
//json值为"{"stu":[{"name":"花狗Fdog","age":22},{"name":"黑狗Fdog","age":23}]}"
//将json格式数据转为value 需保证json_为正确格式字符串
FdogSerialize::Instance()->FDesSerializeL(value, json_);
}#include "macrodefinition.h" //添加序列化所需头文件
//自定义基础类型结构体
struct student{
char * name;
int age;
};
//需要在宏Serialize_type_judgment_all定义下添加嵌套结构体
#define Serialize_type_judgment_all\
Serialize_type_judgment(student)
//依次添加
//需要在宏Serialize_type_judgment_all定义下添加嵌套结构体
#define DesSerialize_type_judgment_all\
DesSerialize_type_judgment(student)
//依次添加
int main()
{
REGISTEREDMEMBER(student, name, age); //需要注册自定义类型，第一个参数为自定义结构体名，后面参数依次为成员名
vector<student> stu;
struct stu_1;
stu_1.name = "花狗Fdog";
stu_1.age = 22;
struct stu_2;
stu_2.name = "黑狗Fdog";
stu_2.age = 23;
stu.push_back(stu_1);
stu.push_back(stu_2);
string json_;
//将value转为json格式数据
FdogSerialize::Instance()->FSerializeM(json_, stu, "stu");
//json值为"{"stu":[{"name":"花狗Fdog","age":22},{"name":"黑狗Fdog","age":23}]}"
//将json格式数据转为value 需保证json_为正确格式字符串
FdogSerialize::Instance()->FDesSerializeM(value, json_);
}#include "macrodefinition.h" //添加序列化所需头文件
//自定义基础类型结构体
struct student{
char * name;
int age;
};
int main()
{
REGISTEREDMEMBER(student, name, age); //需要注册自定义类型，第一个参数为自定义结构体名，后面参数依次为成员名
setAliasName("student", "name", "Aliasname"); //第一个参数为类型，第二参数为原名，第三个参数为别名
//除此之外，也可以使用setAliasNameAll设置多个参数的别名
struct stu;
stu.name = "花狗Fdog";
stu.age = 22;
string json_;
FdogSerialize::Instance()->FSerialize(json_, value, "stu"); //json值为"{{"Aliasname":"花狗Fdog","age":22}}"
}#include "macrodefinition.h" //添加序列化所需头文件
//自定义基础类型结构体
struct student{
char * name;
int age;
};
int main()
{
REGISTEREDMEMBER(student, name, age); //需要注册自定义类型，第一个参数为自定义结构体名，后面参数依次为成员名
setIgnoreField("student", "name"); //第一个参数为类型，第二参数为需要忽略的字段
//除此之外，也可以使用setIgnoreFieldAll设置多个忽略的字段
struct stu;
stu.name = "花狗Fdog";
stu.age = 22;
string json_;
FdogSerialize::Instance()->FSerialize(json_, value, "stu"); //json值为"{{"age":22}}"
}暂无
你可能会有如下疑问：
- 为什么char * 类型算作基础类型
因为json中除了数值型数据，剩下的便是字符串类型，考虑到字符串使用的频率，再加上C++对于C兼容的原因，决定把他作为最基础类型。
-
char 类型怎么传递
由于JSON并不支持单引号，所以将使用数值传递并还原，例如：
char ch = 'A'; //ASCII码十进制为98 //如果一个包含char的结构体转Json，检测到ch的类型为char将自动转为字符，//注意C++的中的转义 std::string json = "{\"ch\":98}"; //相对的，如果一个包含char的json想转为struct std::string json = "{\"ch\":98}"; //建议使用这种方式 //又或者你不知道字符'A'的ASCII码是多少，那么可以使用如下方式，一般情况下不会遇到自己写json std::string json = "{\"ch\":\"char('A')\"}";//库会根据ch的类型，若ch为char类型自动将\"char('A')\"转为98
-
目前支持20个成员的结构体，也可自行添加。
-
关于指针类型的支持，后续会添加，思路是先获取指针类型的值再进行解析。
花狗Fdog(张旭)
vx：sui2506897252
EMail：2506897252@qq.com
该项目签署了Apache-2.0 License，详情请参见LICENSE
Copyright © 2021 花狗Fdog(张旭)
根据 Apache 许可，版本 2.0（“许可”）获得许可； 除非遵守许可，否则您不得使用此文件。 您可以在以下网址获得许可证的副本
http://www.apache.org/licenses/LICENSE-2.0
除非适用法律要求或书面同意，否则软件根据许可证分发的分发是按“原样”分发的，不作任何形式的明示或暗示的保证或条件。 请参阅许可证以了解管理权限的特定语言和许可证下的限制。
如果对您有帮助的话，请帮我点个star！
如果觉得它好用的话，可以推广给你的朋友们！