Golang ProtoBuf
1个俗人 人气:0前言
最近项目是采用微服务架构开发的,各服务之间通过gPRC调用,基于ProtoBuf序列化协议进行数据通信,因此接触学习了Protobuf,本文会对Protobuf的语法做下总结,感兴趣的小伙伴们可以参考借鉴,希望对大家能有所帮助。
gRPC的调用模型如下:
基本规范
文件以.proto做为文件后缀,除结构定义外的语句以分号结尾。
rpc方法定义结尾的分号可有可无。
Message命名采用驼峰命名方式,字段命名采用小写字母加下划线分隔方式。
基本语法
首先看一个简单的示例:
/* 头部相关声明 */ syntax = "proto3"; // 语法版本为protobuf3.0 package user; // 定义包名,可以为.proto文件指定包名,防止消息名冲突。 import "common.proto"; // 导入common.proto option go_package = ".;proto"; //服务 service User { rpc SayHello (SayHelloRequest) returns (SayHelloResponse) {} } //定义请求消息体 message SayHelloRequest { string name = 1; int64 role = 2; } //定义响应消息体 message SayHelloResponse { string message = 1; }
.proto文件的第一个非注释行用于指定语法版本,默认为“proto2”;
package定义包
可以为.proto
文件指定包名,防止消息名冲突。
import 导入包
可以通过import
导入其它.proto中定义的消息;常用于导入一些公共的信息。
正常情况下只能使用直接导入的proto文件的定义;如果需要使用多级import导入的文件,import 可以使用 public 属性。示例如下:
a.proto
import public "common.proto"; // 注意此处使用的是import public import "c.proto";
b.proto
import "a.proto";
在b.proto中可以用common.proto中定义的内容,但是不能用c中的定义的内容。
定义Message
定义message使用“message”关键字,消息的字段声明由4部分构成:字段修饰符 字段类型 字段名称 = 标志号。
格式如下:
message 消息名称 {
[字段修饰符] 字段类型 字段名称 = 标志号;
}
字段修饰符
- singular:默认值,该字段可以出现0次或者1次(不能超过1次);
- repeated:该字段可以重复任意多次(包括0次);
我们可以使用repeated关键字来表示动态数组,示例如下:
message User { repeated int64 id = 1; }
在请求的时候我们可以传[]int64{1, 2, 3, 4}
。
字段类型
关于字段类型,这里列举几个常用的,其它的如果有需要可以直接网上搜。
类型 | 备注 |
---|---|
string | 字符串 |
double | 64位浮点型 |
float | 32位浮点型 |
int32、int64 | 整型 |
bool | 布尔型 |
uint32、uint64 | 无符号整型 |
sint32、sint64 | 有符号的整形 |
字段编号
每个字段都有一个编号,这些编号是 唯一的。该编号会用来识别二进制数据中的字段。编号在1-15范围内可以用一个字节编码表示,在16-2047范围用两个字节表示,所以将15以内得编号留给频繁出现的字段可以节省空间。
枚举类型
在定义消息类型时,我们有可能会为某个字段预定义值的一个列表,我们可以通过enum来添加一个枚举,为每个可能的值添加一个常量。示例如下:
message UserRequest { string name = 1; // 定义性别枚举 enum Gender { UNKNOWN = 0; MAN = 1; WOMAN = 2; } // 定义一个枚举字段 Gender gender = 2; }
注意:所有枚举定义都需要包含一个常量映射到0并且作为定义的首行。
嵌套类型
嵌套类型,也就是字面意思,在 message 消息体中,又嵌套了其它的 message 消息体,一共有两种模式,如下:
syntax = "proto3"; message UserResponse { message User { int64 id = 1; string name = 2; } repeated User users = 1; }
如果在外部消息之外使用内部消息,则需要使用“outermsg.innermsg”的方式,如,需要在UserResponse外使用User, 则应该使用:
UserResponse.User
Map类型
在返回列表的时候,map类型经常用到,可以使用map关键字可以创建一个映射,语法如:
map<key_type, value_type> map_field = N;
- key_type 只能是整数或字符串,enum不能作为key_type;
- value_type 是除了映射(map)意外的任意类型;
示例:
message User { int64 id = 1; string name = 2; } map[int64, User] users = 1;
定义Service
如果想在RPC中使用已经定义好的消息类型,可以在.proto文件中定一个消息服务接口,使用service关键字进行服务定义,如:
service User { rpc SayHello (SayHelloRequest) returns (SayHelloResponse) {} }
加载全部内容