Protocol Buffers学习(4):更多消息类型
介绍一下消息的不同类型和引用
使用复杂消息类型
您可以使用其他消息类型作为字段类型。例如,假设你想在每个SearchResponse
消息中包含Result
消息,您可以在同一个.proto
中定义一个Result
消息类型,然后在SearchResponse
中指定一个Result
类型的字段:
1 |
message SearchResponse { |
引入其他消息文件
在上述示例中,Result
消息类型与SearchResponse
在相同的文件中定义, 如果要使用的消息类型已经在另一个.proto
文件中定义了怎么解决呢?
你可以通过import
引入其他的.proto
文件:
1 |
import "myproject/other_protos.proto"; |
注意
接上边的例子,假如a.proto
引入了b.proto
,但是b.proto
更换了位置,路径变成了test/b.proto
(随便举例),我们有两种解决办法:
- 修改
a.proto
中的import
语句,直接import "test/b.proto"
- 在
b.proto
文件原来的位置,创建一个b.proto
文件,文件内容为import public "test/b.proto"
,就可以了
import
对proto2
和proto3
都适用
嵌套类型
您可以在其他消息类型中定义和使用消息类型,如下,Result
消息定义在SearchResponse
消息中:
1 |
message SearchResponse { |
如果想重复使用Result
,可以用Parent.Type
的方式使用:
1 |
message AnotherResponse { |
修改更新现有的消息格式
修改时要注意的规则:
- 不要改变已经存在字段的标签
- 添加一个字段时,旧的消息将会收到这个字段的默认值
- 删除一个字段时,记得把该字段的标签添加到
reserved
里 - int32,uint32,int64,uint64和bool都是兼容的。这意味着您可以将这些类型之一的字段更改为另一个,而不会破坏前向或后向兼容性。转 大专栏 Protocol Buffers学习(4):更多消息类型换过程相当于C ++中将该数字转换为该类型(例如,如果将64位数字读为int32, 它将被截断到32位)
- sint32和sint64相互兼容,但与其他整数类型不兼容
- 只要字节是有效的UTF-8,字符串和字节是兼容的
- 嵌套消息(message)与包含消息的编码版本的字节(bytes)兼容【表述不清,欢迎大家评论指正】
- fixed32与sfixed32兼容,fixed64与sfixed64兼容
- 枚举兼容int32,uint32,int64和uint64(请注意,如果值不合适,那么值将被截断)。 但是请注意,客户端代码可以在消息反序列化时对它们进行不同的处理:例如,消息中将保留无法识别的proto3枚举类型,但是当消息反序列化时,如何处理和使用的编程语言相关。 Int字段始终保持其值
Any
类型
any类型时谷歌protobuf内置的一个类型,通用类型,使用的时候需要导入google/protbuf/any.proto
1 |
import "google/protobuf/any.proto"; message ErrorStatus { |
Oneof
类型
Oneof结构中有多个字段,但是同一时刻只有一个字段生效
定义oneof结构
1 |
message SampleMessage { |
oneof中可以是任意类型,除了repeated 字段
生成代码之后,也会对oneof字段生成getter,setter方法,但是出来的值需要你自己判断一下
Maps 类型
如果你要定义一个map,protobuf提供了一个语法:
1 |
map<key_type, value_type> map_field = N; |
例如
1 |
map<string, Project> projects = 3; |
注意事项
- Map字段不能是
repeated
- Map中的集合是无序的
.proto
文件生成时,map按key排序- 解析或者合并时,后边的会覆盖前边的
packages语法
你可以添加一个可选标识package
到.proto
文件中。用来防止命名冲突
1 |
package foo.bar; |
在使用这条消息的时候需要加上package
名字
1 |
message Foo { |
Protocol Buffers学习(4):更多消息类型的更多相关文章
- Protocol Buffers学习笔记
Protocol Buffers学习笔记 1. 简介 Protocol Buffers是google发明的一种数据交换格式,独立于语言,独立于平台.与其他的数据交换格式有所不同,Protocol Bu ...
- Protocol Buffers学习教程
最近看公司代码的过程中,看到了很多proto后缀的文件,这是个啥玩意?问了大佬,原来这是Protocol Buffers! 这玩意是干啥的?查完资料才知道,又是谷歌大佬推的开源组件,这玩意完全可以取代 ...
- Google Protocol Buffers学习
参考资料:http://www.cnblogs.com/royenhome/archive/2010/10/29/1864860.html 参考资料:http://www.jianshu.com/p/ ...
- Protocol Buffers官方文档(proto3语言指南)
本文是对官方文档的翻译,大部分内容都是引用其他一些作者的优质翻译使文章内容更加通俗易懂(自己是直译,读起来有点绕口难理解,本人英文水平有限),参考的文章链接在文章末尾 这篇指南描述如何使用protoc ...
- ProtoBuf3语法指南(Protocol Buffers)_上
0.说明 ProtoBuf3语法指南, 又称为proto3, 是谷歌的Protocol Buffers第3个版本. 本文基于官方英文版本翻译, 加上了自己的理解少量修改, 一共分为上下两部分. 1.序 ...
- Language Guide (proto3) | proto3 语言指南(一)定义消息类型
定义消息类型 首先让我们看一个非常简单的例子.假设您想定义一个搜索请求消息格式,其中每个搜索请求都有一个查询字符串.您感兴趣的特定结果页以及每页的结果数.下面是用于定义.proto消息类型的文件. s ...
- rabbitMQ学习笔记(六) topic类型消息。
上一节中使用了消息路由,消费者可以选择性的接收消息. 但是这样还是不够灵活. 比如某个消费者要订阅娱乐新闻消息 . 包括新浪.网易.腾讯的娱乐新闻.那么消费者就需要绑定三次,分别绑定这三个网站的消息类 ...
- gRPC in ASP.NET Core 3.x -- Protocol Buffer(3)更新消息类型
当你第一次定义Protocol Buffer的消息的时候,你肯定会给消息设定一套规则需求.但是随着时间的推进,你的业务可能会发生了变化,与此同时,你的Protocol Buffer消息类型的需求也会随 ...
- 学习ActiveMQ(五):activemq的五种消息类型和三种监听器类型
一.前面我们一直发送的是字符串类型,其实activemq一共支持五种消息类型: 1.String消息类型:发送者:消费者: 1.String消息类型:发送者:消费者: 1.String消息类型:发送者 ...
随机推荐
- kubectl 常用命令一
1.kubectl logs <options> <PodName> -f -p, --previous --since= No. --since-time= --tail ...
- Django_HTML
一.web开发之HTML 1.1 HTML相关基础 快速生成html的模版方法: 在visual code的新建html文件中输入:!然后tab回车就会出现HTML的模版 双标签: <p> ...
- 字典|字典和数组嵌套|keys()|value()|item()|del
python 中没有i++! dic = { 'a':5, 'kelv':'ooo', 5:2333, 2333:'yoo' } print dic[dic[dic['a']]] print dic ...
- Monkey安装与配置教程
一.JAVA环境的搭建 安装jdk1.8.0_221,完成环境变量的配置 然后再在系统变量中找到Path,添加%JAVA_HOME%\bin;,确定后,按win+r打开运行,输入cmd 在cmd窗口中 ...
- poj-3661 Running(DP)
http://poj.org/problem?id=3661 Description The cows are trying to become better athletes, so Bessie ...
- 场景实践篇一:Nginx负载均衡配置
code1 code2 code3 三个文件夹, 每个文件夹下面一个 index.html 的文件夹 cd /etc/nginx/conf.d/ 下面新建 server1.conf ...
- certutil
计算摘要 certutil -hashfile inst.ini MD2 certutil -hashfile inst.ini MD5 certutil -hashfile inst.ini SHA ...
- Error、Bias、Variance及损失函数理解
个人感觉理解误差.偏置.方差的一个好的解释,感谢分享:https://baijiahao.baidu.com/s?id=1601092478839269810&wfr=spider&f ...
- 【ubuntu】乱七八糟
https://blog.csdn.net/totorocyx/article/details/80032556 https://blog.csdn.net/weixin_40662331/artic ...
- 85)PHP,PHP处理mysql的函数种类
首先,就我知道的,一共有三种: 自己用过的是mysql和mysqli,还没用过PDO_mysql 有时,随着我们的各种东西版本的更新,会遇到某一个扩展用不了的情形,所以,就有了编写完成相同功能的使用不 ...