跳到主要内容
版本：0.16

自定义序列化器

当某个类型不是通过 [ForyObject] 生成序列化器，或者需要特殊编码方式时，应使用自定义序列化器。

实现 Serializer<T>​

using Apache.Fory;

public sealed class Point
{
    public int X { get; set; }
    public int Y { get; set; }
}

public sealed class PointSerializer : Serializer<Point>
{
    public override Point DefaultValue => new();

    public override void WriteData(WriteContext context, in Point value, bool hasGenerics)
    {
        context.Writer.WriteVarInt32(value.X);
        context.Writer.WriteVarInt32(value.Y);
    }

    public override Point ReadData(ReadContext context)
    {
        return new Point
        {
            X = context.Reader.ReadVarInt32(),
            Y = context.Reader.ReadVarInt32(),
        };
    }
}

注册序列化器​

Fory fory = Fory.Builder().Build();
fory.Register<Point, PointSerializer>(200);

Point value = new() { X = 10, Y = 20 };
byte[] payload = fory.Serialize(value);
Point decoded = fory.Deserialize<Point>(payload);

序列化器行为说明​

  • WriteData / ReadData 只处理载荷内容。
  • 除非你自行覆盖，否则引用标记和类型信息由基类 Serializer<T>.Write / Read 负责处理。
  • DefaultValue 用于空值或默认值回退路径。

最佳实践​

  1. 保持序列化器的确定性和读写对称性。
  2. 对整数密集型载荷，有意识地选择 varint / fixed / tagged 编码。
  3. 在所有读写节点上注册自定义序列化器。
  4. 对普通领域模型，优先使用生成的 [ForyObject] 序列化器。

相关主题​