Oneof
优质
小牛编辑
132浏览
2023-12-01
注:内容翻译自官网参考文档中 Java Generated Code 的 oneof 一节。
给假设有一个类似这样的oneof定义:
oneof oneof_name {
int32 foo_int = 4;
string foo_string = 9;
...
}
在 oneof_name 这个 oneof 中的所有字段将为他们的值使用共享的 oneof_name 对象。此外,protocol buffer compiler 将为每个oneof case生成一个Java枚举类型,如下所示:
public enum OneofNameCase implements com.google.protobuf.Internal.EnumLite {
FOO_INT(4),
FOO_STRING(9),
...
ONEOF_NAME_NOT_SET(0);
...
};
这个枚举类型的值有下列特殊方法:
- int getNumber(): 返回对象在.proto文件中定义的编号
- static Foo valueOf(int value): 返回对应给定编号的枚举对象,对于其他编号则返回null。
编译器也将在消息类和它的builder中生成下列访问方法:
- OneofNameCase getOneofNameCase(): 返回枚举指示哪个字段被设置。如果一个都没有设置返回 ONEOF_NAME_NOT_SET
编译器将仅在消息的builder中生成下列方法:
- Builder clearOneofName(): 设置 oneof_name 为null,并设置 oneof case 为ONEOF_NAME_NOT_SET