序列化器

核心思想：序列化与反序列化

采用各种成熟的第三方解析库组装成通用API以供简便使用，部分简单的可以自己实现解析器。

用途：

• 持久化存储配置文件 Config
• 网络之间传输数据 DTO
• 不同编程语言之间交换数据

相关语言

• CSV(Comma-Separated Values): 以纯文本的形式存储表格数据
• INI(Initialization File, 初始化文件): 是windows的系统配置文件所采用的存储格式, 后缀名：[.ini]
• JSON(JavaScript Object Notation): (用于WebAPI传输和配置) 后缀名：[.json] 依赖于 Newtonsoft.Json
• Properties: (用户配置)
• Protobuf: (用户WebAPI传输) 后缀名：[.proto]
• SVG
• TOML:
• XML:
• YAML: (Python, Perl, Ruby; 用于持久化和配置) 后缀名：[.yml, .yaml] 依赖于YamlDotNet

序列化器与工厂

ISerializer(序列化器)主要方法为：

Deserialize<TypeEntity>(content: String): TypeEntity # 反序列化 内存中
Deserialize<TypeEntity>(content: String, stream: System.IO.Stream): TypeEntity # 反序列化 流
Serialize(entity: Object): String # 序列化 内存中
Serialize(entity: Object, System.IO.Stream): Void # 序列化 流

工厂通过语言名称获取序列化器

factory.GetByName("YAML"): ISerializer

使用演示

通过JSON的序列化器来演示使用方法

Console.WriteLine("JSON:");
var serializer = new SerializerSharp.JSON.JsonSerializer();
var person = new Person { Name = "Wagsn", Age = 23, Sex = true };
var content = serializer.Serialize(person);
Console.WriteLine("Serialize: \r\n" + content);
var entity = serializer.Deserialize<Person>(content);
Console.WriteLine($"Deserialize: name={entity.Name}, " + entity);
entity.Age++;
Console.WriteLine("Serialize after Modified value: \r\n" + serializer.Serialize(entity));
var entityFromFile = serializer.Deserialize<Person>(System.IO.File.OpenRead("person.json"));
Console.WriteLine($"Deserialize from file: name={entityFromFile.Name}, " + entityFromFile);

预期的目标

可配置，如：

• 序列化模式：压缩与格式化（某些强格式类型不支持）