​ FdogSerialize是一个用于C++序列化和反序列化快速互转开源库，采用非入侵方式，无需在原有结构体上进行修改，支持别名，最少三行代码即可完成转换使得它足够方便。

• FdogSerialize
  • 目录
  • 背景
  • 类型支持
  • 使用说明
  • 作者
  • 许可
  • 其他

​ 经常使用java或者go的人应该知道这些语言在进行序列化和反序列化是很容易的，但是对于伟大的C++而言，这是困难的，根本原因是C++不支持反射，基于c++的语言哲学，C++宁死也要坚守的zero overhead，不为用不到的特性付出任何代价，不管这个代价有多小，也不管是怎样的语言特性，都不会妥协。

​ 虽然C++不支持反射，但是我们依旧可以通过自己的方式实现序列化与反序列化，记得我在大二时用C++写的一个client-server小项目，自己规定了传输的数据格式（当时觉得自己解析Json很麻烦），第一个字段应该是什么，第二个字段应该是什么，正是因为没有方便的函数进行转换，我每次都需要使用非常繁琐的代码去拼出一个可以传递的字符串，是的，这样确实可以完成我想要的功能，但是我自己定的数据格式只适合自己用，这种方式长期必然行不通，而大多数人使用JSON和XML这两种数据格式来保存对象，如果我的项目想要使用这种大众化的数据格式，我又将重构我的代码。

​ 我试着在github寻找一些用于C++的序列化与反序列的库，看看有没有什么办法可以帮助我快速把对象转变成JSON，我找到了一些类似的库，但是有一些设计不太合我心意。

不太和我心意的设计：

• 使用者需要添加过多代码

• 采用入侵方式，需要改变原有的结构体

• 不需要入侵，但是在注册的时候需要一个一个指定类型

• 只支持基础类型组成的结构体转换

• 不支持别名（由于go的特性，在go中经常被使用）
• 不支持指针类型（如果原项目中存在指针类型便需要指针类型）

既然不满意，就自己动手写一个吧，说实话还是有点困难的，虽然说C++中应该尽可能的少用宏，但就目前来说C++没有反射机制，编译后不保存结构体的元信息来说，使用宏是无法绕开的。

暂时分成五期：

1. 支持由基础类型组合成结构体和Json互转【完成】
2. 支持由复杂类型组合成结构体和Json互转【完成】
3. 支持类和Json互转【未完成】
4. 支持vector，map，list等数据类型和Json互转【未完成】
5. 支持XML数据格式【未完成】

杂项支持：

1. 支持别名【完成】
2. 支持字段忽略【未完成】
3. 支持数组转换【完成】

暂时就想到怎么多，欢迎补充！

​ 基于C++的基础类型，FdogSerialize支持如上的20种类型，准确说是15种类型，例如int类型等于signed int类型，只要你的结构体中最基本类型在这20种范围之内，便可完成转换。

什么是最基本类型？例如：

struct headmaster{
	char * name;
	int age;
};

struct student{
	char * name;
	int age;
};

struct teacher{
	char * name;
	int age;
};

struct school{
	char * schoolName;
	headmaster name;
	student stu[1];
	teacher tea[1];
};

虽然school这个结构体包含了headmaster，student，teacher三种自定义类型，但追寻本质，他们的底层都属于最基本类型。

• headmaster，它包含的最基本类型是char *和int。

• student[]是由多个student组成，而student是由最基本类型char *和int构成。

因此school这个结构体完全可以被正常解析，事实上大多数结构体的最基本类型都在这里了。

你可能会有如下疑问：

1. 为什么char * 类型算作基础类型

​ 因为json中除了数值型数据，剩下的便是字符串类型，考虑到字符串使用的频率，再加上C++对于C兼容的原因，决定把他作为最基础类型。

2. char 类型怎么传递？'a' ？

   由于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
   

3. 目前支持20个成员的结构体。

使用说明以及示例请参考doc.md文件

花狗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！

如果觉得它好用的话，可以推广给你的朋友们！

http://192.168.81.39/dzzoffice/index.php?mod=corpus