poroto3 坑 枚举_五.Protobuf3 枚举

Protobuf3 枚举

定义消息类型时，您可能希望它的一个字段有一个预定义的值列表。例如，假设您希望为每个SearchRequest添加一个corpus字段，其中语料库可以是UNIVERSAL、WEB、IMAGES、LOCAL、NEWS、PRODUCTS 或VIDEO。您可以非常简单地通过在消息定义中添加枚举来实现这一点，每个可能的值都是一个常量。

在下面的例子中，我们添加了一个名为Corpus 的枚举和一个类型为Corpus的字段:

message SearchRequest {

string query = 1;

int32 page_number = 2;

int32 result_per_page = 3;

enum Corpus {

UNIVERSAL = 0;

WEB = 1;

IMAGES = 2;

LOCAL = 3;

NEWS = 4;

PRODUCTS = 5;

VIDEO = 6;

}

Corpus corpus = 4;

}

正如你所看到的，Corpus枚举的第一个常量映射到0，每个枚举定义必须包含一个映射到零的常量作为第一个元素。这是因为:

必须有零值，这样我们就可以使用0作为数值默认值。

零值必须为第一个元素，以便与proto 2语义兼容，其中第一个枚举值总是默认的。

可以通过为不同的枚举常量分配相同的值来定义别名。为此，您需要将allow_alias选项设置为true，否则协议编译器会在找到别名时生成错误消息。<