除了Google提供的相当短的style guide之外,这里还有关于命名Google Protocol Buffer消息的想法。Protobuf命名约定
在消息类型名称末尾使用“消息”。
- 这使得在源代码中很容易看到类是protobuf生成的类。这也有一个好处,如果我有一个丰富的域特定的类,那么它可以有真实的名字,比如AddressBookMessage的protobuf类和AddressBook的真实类。
对于Java的用户,它似乎在
Protos
具有java_outer_classname
端是标准的。- 我开始并没有注意到这一点,所以我目前的protobuf类是
com.example.project.protobuf.MyProtos
,但我不明白了一个道理,以保持它有鉴于我们需要有一个包含类,因此它可以被移动到com.example.protobuf.MyProtos
,除非项目的顶层包中没有类。
- 我开始并没有注意到这一点,所以我目前的protobuf类是
在0开始枚举以匹配C/C++。
对重复字段使用单数名称。
- 大多数生成的方法在使用单个字段名称时听起来会更好,即使它是重复的,例如, message-> add_child(),而不是message-> add_children()(如果有一个重复的子字段)。
是否有任何其他标准的人使用或从这些有什么不同?
你是什么意思“在0开始枚举匹配C/C++”的意思? – bialix 2010-11-09 16:14:13
@bialix,为枚举成员赋值,Protobuf样式页面从1开始显示它们,请参阅http://code.google.com/apis/protocolbuffers/docs/style.html中的“enum Foo”。但我看到其他页面上从0开始的其他示例。 – 2010-11-09 18:12:25