ProtoInclude 属性是什么意思（在 protobuf-net 中）

Question

在ProtoBuf-Net 实现中，ProtoInclude 属性是什么意思，它有什么作用？

一个例子将不胜感激。

我看到它in this post，但我不确定它的作用。例如：

[Serializable,
 ProtoContract,
 ProtoInclude(50, typeof(BeginRequest))]
abstract internal class BaseMessage
{
  [ProtoMember(1)]
  abstract public UInt16 messageType { get; }
}

[Serializable,
 ProtoContract]
internal class BeginRequest : BaseMessage
{
    [ProtoMember(1)]
    public override UInt16 messageType
    {
        get { return 1; }
    }
}

另外，有没有办法使用 protogen 工具生成这样的继承？

Answer 1

抱歉，我不是故意错过这个 - 唉，我没有看到所有内容。

鉴于问题中的细节，我假设您至少对 .proto 非常熟悉；如果我错了，请纠正我。

[ProtoInclude] 的工作方式很像 [XmlInclude] 的 XmlSerializer - 或 [KnownType] 的 DataContractSerializer - 它允许它在（反）序列化期间识别类型的子类。唯一额外的一点是它需要一个标签（数字）来标识每个子类型（必须是唯一的，并且不与父类型中的任何字段冲突）。

重新原生质：不；底层规范（由 google 提供）根本没有规定继承，因此 protogen（通过 .proto）没有表达这一点的机制。 protobuf-net 作为 extension 提供继承支持，但这样做的方式仍然使消息与其他实现兼容。在推动下，也许我可以通过 google 规范中的新扩展属性添加 protogen 支持，但我还没有这样做。

所以;看例子；表示BaseMessage和BeginRequest之间的继承关系；不管你是否这样做：

Serialize<BaseMessage>(...)
Serialize<BeginRequest>(...)

• 无论哪种方式，它都会从底部（BaseMessage）开始向上工作；这不是 exactly true - 它以 BeginRequest 开头写入 data （以便在反序列化期间尽早知道我们有 BeginRequest）。重要的是包含来自任何父合约类型的字段，并且序列化程序会查看传入的 actual 对象 - 而不仅仅是您说它的类型。

同样，在反序列化过程中，无论您是否使用：

Deserialize<BaseMessage>(...)
Deserialize<BeginRequest>(...)

你会得到你实际序列化的类型（大概是BeginRequest）。

在引擎盖下，出于兼容性目的（使用宽协议缓冲区规范），这类似于编写类似（请原谅任何错误，我的 .proto 已生锈）：

message BaseMessage {
    optional BeginRequest beginRequest = 50;
    optional uint32 messageType = 1;   
}
message BeginRequest {        
}

（覆盖可能不应该指定[ProtoMember]，顺便说一句。

通常，它会按标签升序写入字段，但为了高效反序列化，引擎厚颜无耻地选择写入子类数据first（规范明确允许） - 即它写入类似的东西（你必须想象二进制......）：

[tag 50, string][length of sub-message][body of sub-message][tag 1, int][value]

（在这种情况下，子消息的正文为空）

这包括它吗？