快速序列化组件MessagePack介绍

MessagePack for C＃（MessagePack-CSharp）是用于C＃的极速MessagePack序列化程序，比MsgPack-Cli快10倍，与其他所有C＃序列化程序相比，具有最好的性能。 MessagePack for C＃具有内置的LZ4压缩功能，可以实现超快速序列化和二进制占用空间小。 性能永远是重要的！ 可用于游戏，分布式计算，微服务，数据存储到Redis等。支持.NET, .NET Core, Unity, Xamarin。

从上图我们看出MessagePack for C＃在性能测试中是最好的，这里解释一下第三个MsgPack-Cli是MessagePack官方实现的。第一和第二都是MessagePack for C＃，第一项相比第二项具有稍快一点的序列化和反序列化速度，但是第二项采用了L4压缩功能，显著的减少了二进制的大小。在实际使用中推荐使用L4压缩功能。

使用

定义一个类添加[MessagePackObject]特性，公共成员（属性或者字段）添加[Key]特性，调用MessagePackSerializer.Serialize/Deserialize进行序列化和反序列化，ToJson可以帮我们转储二进制为json格式。

// 标记 MessagePackObjectAttribute
[MessagePackObject]
public class MyClass
{
	// Key 是序列化索引，对于版本控制非常重要。
	[Key(0)]
	public int Age { get; set; }

	[Key(1)]
	public string FirstName { get; set; }

	[Key(2)]
	public string LastName { get; set; }

	// 公共成员中不序列化目标，标记IgnoreMemberAttribute
	[IgnoreMember]
	public string FullName { get { return FirstName + LastName; } }
}

class Program
{
    static void Main(string[] args)
    {
		var mc = new MyClass
	    {
		    Age = 99,
		    FirstName = "hoge",
		    LastName = "huga",
	    };

	    // 序列化
	    var bytes = MessagePackSerializer.Serialize(mc);
		//反序列化
	    var mc2 = MessagePackSerializer.Deserialize(bytes);

		// 你可以将msgpack二进制转储为可读的json。
		// 在默认情况下，MeesagePack for C＃减少了属性名称信息。
		// [99,"hoge","huga"]
		var json = MessagePackSerializer.ToJson(bytes);
	    Console.WriteLine(json);

	    Console.ReadKey();

	}
}

序列化索引将会影响该信息在序列化数据中的位置

默认情况下特性是必须的，但是我们有方法进行改变，让它变为不是必须的，详情请看后面。

分析器

这些类型可以默认序列化。

基元（int、string等等）, Enum, Nullable<>, TimeSpan, DateTime, DateTimeOffset, Nil, Guid, Uri, Version, StringBuilder, BitArray, ArraySegment<>, BigInteger, Complext, Task, Array[], Array[,], Array[,,], Array[,,,], KeyValuePair<,>, Tuple<,...>, ValueTuple<,...>, List<>, LinkedList<>, Queue<>, Stack<>, HashSet<>, ReadOnlyCollection<>, IList<>, ICollection<>, IEnumerable<>, Dictionary<,>, IDictionary<,>, SortedDictionary<,>, SortedList<,>, ILookup<,>, IGrouping<,>, ObservableCollection<>, ReadOnlyOnservableCollection<>, IReadOnlyList<>, IReadOnlyCollection<>, ISet<>, ConcurrentBag<>, ConcurrentQueue<>, ConcurrentStack<>, ReadOnlyDictionary<,>, IReadOnlyDictionary<,>, ConcurrentDictionary<,>, Lazy<>, Task<>, 自定义继承ICollection <>或IDictionary <,>具有无参构造方法, IList，IDictionary和自定义继承ICollection或IDictionary具有无参构造函数（包括ArrayList和Hashtable）。

您可以添加自定义类型的支持和一些官方/第三方扩展包。 对于ImmutableCollections（ImmutableList <>等），对于ReactiveProperty和Unity（Vector3, Quaternion等等），对于F＃（Record，FsList，Discriminated Unions等）。

MessagePack.Nil是MessagePack for C＃的内置null/void/unit表示类型。

对象序列化

您可以使用[DataContract]而不是[MessagePackObject]。 如果type标记为DataContract，则可以使用[DataMember]代替[Key]，[IgnoreDataMember]代替[IgnoreMember]。

[DataMember(Order = int)] 和 [Key(int)]相同, [DataMember(Name = string)]和 [Key(string)]相同. 如果使用 [DataMember], 则类似于 [Key(nameof(propertyname)].

使用DataContract使其成为一个共享的类库，您不必引用MessagePack for C＃。 但是，它不包含在分析器或由mpc.exe生成的代码中。此外，像UnionAttribute，MessagePackFormatterAttribute，SerializationConstructorAttribute等功能不能使用。 出于这个原因，我建议您基本上使用MessagePack for C＃特性。

序列化不可变对象（序列化构造器）

如果对象实现了IMessagePackSerializationCallbackReceiver，则接受OnBeforeSerialize和OnAfterDeserialize序列化处理。

[MessagePackObject]
public class SampleCallback : IMessagePackSerializationCallbackReceiver
{
    [Key(0)]
    public int Key { get; set; }

    public void OnBeforeSerialize()
    {
        Console.WriteLine("OnBefore");
    }

    public void OnAfterDeserialize()
    {
        Console.WriteLine("OnAfter");
    }
}

Union

如果使用MessagePackSerializer.Deserialize