Protobuf 更新原有消息格式注意事项
作者:
XBruce | 来源:发表于
2020-03-31 09:15 被阅读0次如果一个已有的消息格式已无法满足新的需求，比如：要在消息中添加一个额外的字段——但是同时旧版本写的代码仍然可用。更新消息而不破坏已有代码是非常简单的。在更新时只要记住以下的规则即可。
- 不要更改任何已有的字段的数值标识
- 所添加的任何字段都必须是optional或repeated的
- 非required的字段可以移除（更好的做法是添加前缀“OBSOLETE_”，或者标记成保留字段号 reserved，以便将来的 .proto 用户不会意外使用该号码 ）
message Foo {
reserved 2, 15, 9 to 11;
reserved "foo", "bar";
}
- 一个非required的字段可以转换为一个扩展，反之亦然——只要它的类型和标识号保持不变。
- int32, uint32, int64, uint64,和bool是全部兼容的，这意味着可以将这些类型中的一个转换为另外一个，而不会破坏向前、 向后的兼容性
- sint32和sint64是互相兼容的，但是它们与其他整数类型不兼容。
- string和bytes是兼容的——只要bytes是有效的UTF-8编码。
- 嵌套消息与bytes是兼容的——只要bytes包含该消息的一个编码过的版本。
- fixed32与sfixed32是兼容的，fixed64与sfixed64是兼容的。
-
本文标题：Protobuf 更新原有消息格式注意事项
本文链接：https://www.haomeiwen.com/subject/dhmmuhtx.html
网友评论