开发学院

您的位置:首页>教程>正文

教程正文

Protocol Buffer JAVA实例教程:扩展Protocol Buffer

  在您发布使用Protocol Buffer区的代码后,您迟早会因为业务需求变更想要“改进”Protocol Buffer的定义。如果你想让你的新Protocol Buffer向后兼容,让你的旧Protocol Buffer向前兼容,那么你需要遵守一些规则。在新版本的Protocol Buffer中:

  •   您不能更改任何现有字段的标签号。

  •   您不得添加或删除任何必填字段。

  •   您可以删除可选或重复的字段。

  •   您可以添加新的可选或重复字段,但必须使用新的标签号(即,从未在此Protocol Buffer中使用过的标签号,甚至未被删除的字段使用过)。

  (这些规则有一些例外,但很少使用。)

  如果您遵循这些规则,旧代码将无缝兼容新消息,并忽略掉新字段。对于旧代码,被删除的可选字段将只具有它们的默认值,被删除的重复字段将为空。新代码也会透明地读取旧消息。但是,请记住,新的可选字段不会出现在旧消息中,因此您需要显式检查它们是否设置了has_,或者在您的.proto文件中提供一个合理的默认值,在标签号后面加上[default = value]。如果没有为可选元素指定默认值,则使用特定于类型的默认值:对于字符串,默认值为空字符串。对于布尔值,默认值为false。对于数值类型,默认值为零。还要注意,如果您添加了一个新的重复字段,您的新代码将无法判断它是空的(由新代码)还是根本没有设置(由旧代码),因为它没有has_ 标记。

高级用法

  Protocol buffer的使用超越了简单的访问器和序列化。请务必浏览一下Java应用编程接口参考,看看您还可以用它们做些什么。

  协议消息类提供的一个关键特性是反射。您可以迭代消息的字段和摆布它们的值,而无需针对任何特定的消息类型编写代码。使用反射的一个非常有用的方法是将协议消息转换成其他编码,如XML或JSON。反射的一个更高级的用途可能是发现相同类型的两个消息之间的差异,或者开发一种“协议消息的正则表达式”,在这种表达式中,您可以编写与某些消息内容匹配的表达式。如果你运用你的想象力,就有可能将Protocol Buffers应用到比你最初预期的更广泛的问题上!

  反射是作为消息和Message.Builder接口的一部分提供的。