Protocol Buffers 学习（3）：枚举类型

首先我们看一个枚举类型的例子

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必须是第一个元素

这样有两个好处

• 0正好是数字类型的默认值
• 0始终作为第一个元素，这样可以和proto2兼容

值重复问题

你可以为不同的枚举常量赋相同的值，但是要设置allow_alias为true

enum EnumAllowingAlias {
  option allow_alias = true;
  UNKNOWN = 0;
  STARTED = 1;
  RUNNING = 1;
}
enum EnumNotAllowingAlias {
  UNKNOWN = 0;
  STARTED = 1;
  // RUNNING = 1;  // 取消这行的注释 会报错
}

更多说明

• 枚举常量必须在32位整数范围内，因为枚举值线上使用varint编码，所以负值无效，不推荐在枚举中定义负值
• 反序列化的时候，消息将保留不能识别的枚举值

更多信息请参考Google