protos

Protobuf 格式的数据结构和消息协议。都在同一个 protos 包内。

这里面是所有基本的数据结构（message）定义和 GRPC 的服务（service）接口声明。

所有的 .proto 文件是 protobuf 格式的声明文件，.pb.go 文件是基于 .proto 文件生成的 go 语言的类文件。

protobuf 工具可以从 这里 下载，推荐使用 3.0 版本系列。

下载安装后，需要安装对应语言的编译器，例如要生成 go 语言代码，则需要安装 protoc-gen-go。

$ go get github.com/golang/protobuf/protoc-gen-go

可以使用 protobuf 编译器基于 protobuf 模板文件来生成各种语言的类文件。

$ protoc \--proto_path=IMPORT_PATH \--cpp_out=DST_DIR \--java_out=DST_DIR \--python_out=DST_DIR \--go_out=DST_DIR \--ruby_out=DST_DIR \--javanano_out=DST_DIR \--objc_out=DST_DIR \--csharp_out=DST_DIR \path/to/file.proto

其中，--proto_path=IMPORT_PATH 是当 proto 文件中存在导入时候，进行查找的路径，等价于 -I=IMPORT_PATH，可以多次使用来指定多个导入路径。

为了生成支持 grpc 的代码，还可以提供生成参数 plugins=grpc，例如

$ protoc \--proto_path=IMPORT_PATH \--go_out=plugins=grpc:DST_DIR \ path/to/file.proto

另外，生成的结构体，一般都至少默认支持 4 个默认生成的方法。

• Reset()：重置结构体。
• String() string：返回代表对象的字符串。
• ProtoMessage()：协议消息。
• Descriptor([]byte, []int)：描述信息。