本文将描述如何使用protocol buffer 语言构造你的protocol buffer数据,包括.proto文件语法规则,以及如何由.proto文件生成数据访问类。本文涵盖了proto3版本的协议语言:想了解proto2的语法,查看 Proto2 语言指南.
这是一个参考指南——给出了一步一步的操作的示例,示例使用了本文中描述的很多特性,这里有适合你所选语言的教程:
定义一个消息类型
首先让我们来看一个非常简单的例子。假定我们有这样的需求,我们要定义一个搜索请求消息,每个消息都包含一个查询字符串,和你感兴趣的特定页面编号,以及每个页面的命中个数。
syntax = "proto3";
message SearchRequest {
string query = 1;
int32 page_number = 2;
int32 result_per_page = 3