proto文件详解
1,message介绍message:protobuf中定义一个消息类型是通过关键字message字段指定的。消息就算需要传输的数据格式的定义。message关键字类似于C++中的class,Java中的Class,go中的struct
例如:
在消息中承载的数据分别对应于每一个字段。
其中每个字段都有一个名字和一种类型。
2,字段规则
required:消息体中必填字段,不设置会导致编解码异常。一般不填就认为是必填字段了。
optional:消息体中可选字段。生成的是对应的指针。
repeated:消息体中可重复字段,重复的值的顺序会被保留,在go中重复的会被定义为切片。
这里我们来定义一下
然后我们生成一下
看下文件
这里就变成了一个切片
3,字段映射
4,默认值
protobuf3删除了protobuf2中用来设置默认值的default关键字,取而代之的是protobuf3为各类型定义的默认值,也就是约定的默认值,如下表:
5,标识号
标识号:在消息体的定义中,每个字段都必须要有一个唯一的标识号,标识号是范围内的一个整数。
以Person为例,name=1,id=2,email=3,phones=4中的1-4就是标识号
6,定义多个消息类型
一个proto文件中可以定义多个消息类型
7,嵌套消息
可以在其他消息类型中定义,使用消息类型,在下面的例子中,Person消息就定义在PersonInfo消息内
如果你想在它的父消息类型的外部重用这个消息类型,你需要以PersonInfo.Person的形式来使用它,如:
当然,你也可以将消息嵌套任意多层,如:
8,定义服务
如果想要将消息类型用在RPC系统中,可以在.PROTO文件中定义一个RPC服务接口,protocolbuffer编译器会根据所选择的不同语言生成服务接口代码及存根。
上述代表表示,定义了一个RPC服务,该方法接收SearchRequest返回SearchResponse
<hr/>码字不易还望点个赞,点个关注多多支持一下!部分内容来自互联网,如有侵权请告知删除。
页:
[1]