使用proto3

Last updated 5 months ago

这章将会讨论开发者如何使用Protocol Buffers进行API设计。为了简化用户体验和提高运行效率,gRPC应该使用Protocol Buffers 3(proto 3)来进行API定义。

Protocol Buffers是一门语言中立和平台中立的用来定义数据结构模式以及编程接口的简单接口定义语言(IDL)。它同时支持二进制和文本格式,而且可以在不同的平台与许多不同的线路协议配合工作。

Proto3是Protocol Buffers的最新版本,相对于版本2,其有以下的一些改变:

  • 字段存在性,或者被称为hasField,不再被原始字段支持。未设置值的原始字段将会被赋予一个由语言定义的默认值。

    • 不过仍然可以判断一个字段是否存在。可以使用编译器生成的hasField方法进行测试,又或者是将该字段的值和null,或由具体实现定义的标记值进行比较。

  • 不再支持用户自定义字段的默认值。

  • 枚举定义必须从零开始。

  • 不再支持 required 字段。

  • 不再支持扩展,请使用 google.protobuf.Any代替。

    • 出于向后兼容和运行时兼容的考虑,google/protobuf/descriptor.proto被赋予了特权。

  • 删除了Group语法。

删除这些特性是为了让API的设计变得更简洁,更稳定,更具性能。例如,我们将消息记录为日志消息时常常要将消息的一些敏感字段删除,如果这些字段是required的,这个需求就不可能做到了。

查看Protocol Buffers获取更多的信息。