Google Protocol Buffers 语法整理

1、简单定义一个Message类型

Protocol Buffers 语法文件以 .proto 为文件扩展名。在版本proto3文件头需要包含版本类型 syntax = "proto3"; 缺省情况为proto2类型。

/*message     为类标识符SearchRequest   为类名string/int32    为字段类型query/page_number/result_per_page   为字段名称1/2/3   为编号标签，用于序列化后内容标识序号1~15需要1个字节，16~2047需要2个字节最小编号为1，最大编号229-1或536870911。19000~19999系统预留，不可用。*///官方示例syntax = "proto3";message SearchRequest {  string query = 1;  int32 page_number = 2;  int32 result_per_page = 3;}

2、字段描述规则

字段的规则主要分为单数和复数，用于描述字段是否是单个字段还是数组。默认情况下字段定义都是单数 singular ，如果需要定义数组需要在字段类型前面加 repeated。

3、添加注释

可以在字段定义结束后加 // 注释，该注释会在生成的字段代码中。

//官方示例：message SearchRequest {  string query = 1;   int32 page_number = 2;  // Which page number do we want?    int32 result_per_page = 3;  // Number of results to return per page.}

4、保留字段

编号定义后，无法更改，如果需要重新定义类型或删除旧的类型，需要在序列化文件中占位原定义的类型。这样才能保证更改后数据正常反序列化，并对以前数据兼容。否则数据格式不正确后，将导致对更改前的数据反序列化出错.

 //官方示例：message Foo {  reserved 2, 15, 9 to 11;  reserved "foo", "bar";}

参考链接

[译]Protobuf 语法指南
Protocol Buffers 3.0 技术手册
阅读Google Protocol Buffers 指南