protobuf 语法简介

protobuf 语法简介

1.基本语义

在.proto文件中，最基本的数据类型为message，如其定义所示，由message引导，以后是message类型的名字，以后是由{}包含的各个域(fields)。

required string name = 1; 域字义的一个例子。

required 表示这个域是必需的

optional 该域选，出现0次或１次

repeated 重复出现，0次或屡次

string是域的类型，但是简单的标量类型（如bool,int32,float,double,string等），也但是复合类型(message,enum等)

name是域的名字，=1是给域一个数字标签，这会影响到该域在二进制文件中顺序。

关于这个数字标签也是有说明的，1到15是只使用一个字节编号，而其余的使用多个字节，因此应把1-15编号给最常用的域。数字标签的最大值为2^29 - 1(或536,870,911)，其中还有一段是保留用于proto的实现，从19000到19999(FieldDescriptor::kFirstReservedNumber到FieldDescriptor::kLastReservedNumber)。

有optional说明的域能够有一个默认值，在不指定该域时使用，如optional PhoneType type = 2 [default = HOME];

还有一种类型是enum，如上enum PhoneType的定义。类型能够定义在一个message类型中，也能够单独定义，如上enum PhoneType和message PhoneNumber是嵌套定义在message Person中，message AddressBook中单独定义的。

能够访问一个嵌套定义在另外一个message类型中的message，但需使用域范围标示，如同的c++里使用另外一个命名空间的类：person::PhoneNumber。

添加注释：//

optional int32 page_number = 2;// Which page number do we want?

2.导入

导入：proto能够导入在不一样的文件中的定义。经过在文件顶端加入一个import语句

import "myproject/other_protos.proto";

3.扩展

扩展：proto支持将必定范围内的数字编号做为扩展时使用。

message Foo {

// ...

extensions 100 to 199;

}

extend Foo {

optional int32 bar = 126;

}

4.包

proto支持包的使用，以防止命名冲突。在文件的开始部分指定：package tutorial。不一样的语言在生成代码对包的处理是不一样的：c++中做为命名空间，java中也做包，python中是模块。

options：可以使用option来指定一些选项，会对生成的代码有一些影响。option分文件层的和域层的。在上面的例子中就使用了文件层的：

option java_package = "com.example.tutorial";

option java_outer_classname = "AddressBookProtos";

5.生成代码：使用protoc编译器就能够生成相应语言的代码。

protoc --proto_path=IMPORT_PATH --cpp_out=DST_DIR --java_out=DST_DIR --python_out=DST_DIR path/file.proto

protoc.exe是编译器的名字；--proto_path指定对导入文件的搜索路径，若不指定，则为当前路径；--cpp_out指定生成c++文件的路径，--java_out和 --python_out分别是生成java和python代码的路径；path/file.proto是定义结构的.proto文件。

使用c++语言，会生成针对每一个message类型的一个类，对每个类也提供了相应的处理方法，还提供了序列化到输出流和从输入流中解析的方法。

原文

http://blog.itpub.net/post/42700/527047

http://www.cnblogs.com/mydomain/p/3176373.html