C#使用protobuf-net进行序列化的详细操作

protobuf 是 google的一个开源项目，可用于以下两种用途：

（1）数据的存储（序列化和反序列化），类似于xml、json等；

（2）制作网络通信协议。

源代码下载地址：https://github.com/mgravell/protobuf-net；

开源项目地址如下：https://code.google.com/p/protobuf-net/。

前一篇文章我们看到使用Google.Protobuf有诸多不便（参考《www.jb51.net/article/230186.htm》），这次我们来看看另一个工具的使用体验。

相关资料、链接：

• github项目：https://github.com/protobuf-net/protobuf-net

• nuget包名称：protobuf-net、protobuf-net.BuildTools

• 作者：Marc Gravell

• 支持.net平台：.net5\.NETFramework4.6.1\.NETStandard2.0等

• protobuf-net BuildTools文档：https://protobuf-net.github.io/protobuf-net/build_tools

准备工作

在C#中编写目标类型：

在类级别增加注解[ProtoContract]，在字段级别增加注解[ProtoMember(orderxxx)]

[ProtoContract]
   public class ErrorLog
   {
       [ProtoMember(1)]
       public string LogID { get; set; }
       [ProtoMember(2)]

public string Context { get; set; }
       [ProtoMember(3)]

public string Stack { get; set; }
   }

当安装了protobuf-net.BuildTools工具后，还可以在开发时对目标类型（添加了[ProtoContract]注解）的定义进行检查，比如字段顺序重复、使用的字段类型不符合protobuf要求等。比如因疏忽设置了重复的字段顺序，提示效果如下：

序列化操作

public static byte[] Serialize(ErrorLog log)
       {
           using (MemoryStream memoryStream = new MemoryStream())
           {
               ProtoBuf.Serializer.Serialize(memoryStream, log);
               return memoryStream.ToArray();
           }
       }

反序列化操作

public static ErrorLog DeSerialize(byte[] data)
       {
           using (MemoryStream ms = new MemoryStream(data))
           {
               return ProtoBuf.Serializer.Deserialize<ErrorLog>(ms);
           }
       }

总结、理解

• 这个工具的使用体验属于Code-First模式，先定义类型，并使用注解进行标记，不需要先编写.proto文件。

• 通过类库提供的ProtoBuf.Serializer.Serialize()和ProtoBuf.Serializer.Deserialize()分别执行序列化和反序列化，而不用依赖任何生成的代码。

• 只针对.NET平台的话，不需要.proto文件就可以应用protobuf序列化协议。如果需要跨语言编程，再根据C#类型编写.proto文件（也可以通过工具自动生成proto文件），然后生产目标语言的对应类型。

• 借助于protobuf-net.BuildTools工具的辅助，可以及早的发现编码错误，一定程度上提高了开发效率。

• 综上，对于.NET平台为主的开发者来说，使用protobuf-net相对来说代码可读性更高、维护成本更小，同时也能兼顾跨语言开发，建议首先此方式。

来源：https://www.cnblogs.com/chen943354/p/15601287.html