标签:
总的来说,proto3 比 proto2 支持更多语言但 更简洁。去掉了一些复杂的语法和特性,更强调约定而弱化语法。如果是首次使用 Protobuf ,建议使用 proto3 。
在第一行非空白非注释行,必须写:
syntax = "proto3";
字段规则移除了 “required”,并把 “optional” 改名为 “singular”;
在 proto2 中 required 也是不推荐使用的。proto3 直接从语法层面上移除了 required 规则。其实可以做的更彻底,把所有字段规则描述都撤销,原来的 repeated 改为在类型或字段名后加一对中括号。这样是不是更简洁?
语言增加 Go、Ruby、JavaNano 支持;
移除了 default 选项;
在 proto2 中,可以使用 default 选项为某一字段指定默认值。在 proto3 中,字段的默认值只能根据字段类型由系统决定。也就是说,默认值全部是约定好的,而不再提供指定默认值的语法。
在字段被设置为默认值的时候,该字段不会被序列化。这样可以节省空间,提高效率。
但这样就无法区分某字段是根本没赋值,还是赋值了默认值。这在 proto3 中问题不大,但在 proto2 中会有问题。
比如,在更新协议的时候使用 default 选项为某个字段指定了一个与原来不同的默认值,旧代码获取到的该字段的值会与新代码不一样。
另一个重约定而弱语法的例子是 Go 语言里的公共/私有对象。Go 语言约定,首字母大写的为公共对象,否则为私有对象。所以在 Go 语言中是没有 public、private 这样的语法的。
枚举类型的第一个字段必须为 0 ;
这也是一个约定。
移除了对分组的支持;
分组的功能完全可以用消息嵌套的方式来实现,并且更清晰。在 proto2 中已经把分组语法标注为『过期』了。这次也算清理垃圾了。
旧代码在解析新增字段时,会把不认识的字段丢弃,再序列化后新增的字段就没了;
在 proto2 中,旧代码虽然会忽视不认识的新增字段,但并不会将其丢弃,再序列化的时候那些字段会被原样保留。
我觉得还是 proto2 的处理方式更好一些。能尽量保持兼容性和扩展能力,或许实现起来也更简单。proto3 现在的处理方式,没有带来明显的好处,但丢掉了部分兼容性和灵活性。
移除了对扩展的支持,新增了 Any 类型;
Any 类型是用来替代 proto2 中的扩展的。目前还在开发中。
proto2 中的扩展特性很像 Swift 语言中的扩展。理解起来有点困难,使用起来更是会带来不少混乱。
相比之下,proto3 中新增的 Any 类型有点想 C/C++ 中的 void* ,好理解,使用起来逻辑也更清晰。
增加了 JSON 映射特性;
语言的活力来自于与时俱进。当前,JSON 的流行有其充分的理由。很多『现代化』的语言都内置了对 JSON 的支持,比如 Go、PHP 等。而 C++ 这种看似保罗万象的学院派语言,因循守旧、故步自封,以致于现出了式微的苗条。
原因 #1: 模式本身很不错有一种痛苦的讽刺指向一个事实,我们小心谨慎地在我们的数据库里面编写数据模型,维护各个层次的代码,保持这些数据模型处于控制之中,当我们想要发送数据连接到另一个服务的时候,要求所有的疑虑都要被考虑到。然而,我们往往依靠的是在边界上与我们的系统之间不一致的代码,我们的系统不能强制结构化我们的数据组件,这是如此的重要,编码的语义是你曾经的业务对象,在proto格式中,它足以帮助并保证应用程序之间的信号不会丢失,而界限就在你所创建并执行的业务规则。
|
原因 #2: 无偿地向后兼容被编号的字段在proto的定义中排除了所需的版本检查,这是其中一个被明确表述的动机(为什么这样设计和实现Protocol Buffers)。如同开发者文档中声明的那样,协议被设计成能在一定程度上避免出现像下面这样的“丑陋的代码”,下面的代码用来检测协议的版本:
同编号字段一样, 你必须改变编码习惯,朝着能向老版本维护和向后兼容的方向改变。正如在文档中的声明那样,曾经 Protocol Buffers 是这样被介绍的:
已经部署各种JSON的服务器已经遭受各种与发展模式以及向后兼容的相关问题。我现在深信编号字段能防止错误,并且能在新功能和服务的推出上做到简化。 |
原因 #3: 更少的样本代码除了显式的版本检查和缺乏后续的兼容性,JSON终端在HTTP上的基础服务通常依赖专门的手写样板代码去处理Ruby对象的编码和解码。解析和反解析类常常包含隐藏的业务逻辑,它暴露了手动解析每个新的数据类型的缺陷,当一个类通过Protocol Buffers产生(你一般就不会再去触碰它),它能提供大量相似的方法,还避免了大量头痛的事情。随着模式的发展,你将会用proto产生类(应当承认,一旦你更新他们),你可以把更多的空间留给你所关注的挑战(保持你的应用运行和持续构建产品)。 |
原因 #4: 验证和可扩展性required,optional 和 repeated关键字在Protocol Buffers中的定义是非常强大的。它们允许你去编码,在模式级别,形象化你的数据结构和去实现类怎样工作(每种编程语言处理)的细节。Ruby的protocol_buffers库将会提升异常,例如:如果一个对象实例没有填写必填的字段,你试着去对这样一个对象实例编码,就会提升异常。通过简单地编辑一个新的编号字段的值,你可以把一个字段从required变成optional或者反之亦然。有了这种灵活编码的语义序列化格式,大大增强了其功能。 因为你还可以嵌入proto,定义内部的其他成员,你也可以拥有通用的Request和Response结构,它还允许其他数据结构的传输并确保传输连接上,它为服务器间通讯实现真正的灵活性和安全的数据传输提供了机会。类似Riak的数据库系统使用Protocol Buffers有巨大的效果——因为有了一些启示,我建议重新审视那些接口。 |
原因#5:建议的语言互操作性 因为Protocol Buffers已经被多种语言实现,在你的架构中多语言混合的应用程序之间的互操作性变得更简单。如果你引入了一个新的服务在JAVA或者GO中,甚至和用Node或者Clojure或者Scala实现的后端通讯,你只需简单的把proto文件交给目标语言编写的代码生成器,你将在这些架构之间获得较好的安全和互操作性。平台特定数据类型的细节被目标语言处理,你将更多的关注你的问题的困难部分,而不是匹配字段和数据类型在JSON的编码和解码方案中。 |
什么时候更适合使用JSON?有些时候JSON比Protocol Buffers更适合,包括如下的场景:
可能还有更多的情况。最后,总之,这是很重要的在心里权衡和不要盲目的选择一项技术 |
结论Protocol Buffers提供了几种相对JSON在内部服务之间在线传输数据的引人注目的优势。并没有完全的替换JSON,特别是服务和web浏览器直接通讯的情况,Protocol Buffers提供了真正的优势不仅在上面概述的方法,也编解码的速度和数据大小上有更多的优势。 你可以从你的应用程序中提取出哪些服务?如果你今天不得不做出选择,你会选择JSON还是Protocol Buffers?让我们讨论讨论-我们愿意在下面的评论中听到更多关于你在使用JSON和Protocol Buffers上的经验。 |
1234567891011121314151617181920212223242526272829package com.shunwang.swbox.common.bo.redis.proto;
option java_package =
"com.shunwang.swbox.common.bo.redis.proto"
;
option java_outer_classname =
"IssMatchRanking"
;
//赛事榜单
message IssMatchRankingProto {
optional int32 rowNum = 1;//这的数字是属性的排序
optional int32 matchUserId = 2;
optional int32 gameId = 3;
optional int32 matchId = 4;
optional int32 userId = 5;
optional string subAccount = 6;
optional string roleName = 7;
optional string serverName = 8;
optional string barName = 9;
optional int32 matchNum = 10;
optional int32 killManCnt = 11;
optional int32 hurtCnt = 12;
optional int32 highestWinCnt = 13;
optional int32 battleCnt = 14;
optional string grading = 15;
optional string reward = 16;
}
//赛事榜单列表
message IssMatchRankingListProto {
repeated IssMatchRankingProto issMatchRanking = 1;
}
1. 如上述代码,是需要对需要的数据结构进行构建一个.proto的文件 。以下有官网demo
https://developers.google.com/protocol-buffers/docs/overview#how-do-they-work
2. 下载protobuf工具包:https://github.com/google/protobuf/releases/tag/v2.6.1 自己挑选对应版本
这里注意,需要下载里面的protoc-2.6.1-win32.zip 然后解压到上面下载的工具包目录下
3. 然后在上述工具目录下cmd执行 protoc -I=$SRC_DIR --java_out=$DST_DIR $SRC_DIR/IssMatchRanking.proto 就会生成对应的java
文件。之后就可以愉快的相互转换了,如下例子:
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152
/**
* 从缓存中 获取比赛排名信息
* @param key
* @return
*/
private
List<IssMatchRanking> getRankingFromCache(
byte
[] key) {
List<IssMatchRanking> issMatchRanking =
null
;
try
{
byte
[] values = redisTool.get(key);
if
(values !=
null
) {
issMatchRanking =
new
ArrayList<IssMatchRanking>();
IssMatchRankingListProto issMatchRankingListProto = IssMatchRankingListProto.parseFrom(values);
if
(issMatchRankingListProto.getIssMatchRankingCount() >
0
) {
List<IssMatchRankingProto> IssMatchRankingProtos = issMatchRankingListProto.getIssMatchRankingList();
for
(IssMatchRankingProto issMatchRankingProto : IssMatchRankingProtos) {
issMatchRanking.add(
this
.protoToRanking(issMatchRankingProto));
}
}
}
}
catch
(InvalidProtocolBufferException e) {
LOGGER.error(e.getMessage(), e);
}
return
issMatchRanking;
}
/**
* IssMatchUserExtProto 转 IssMatchUserExt
* @param issMatchProto
* @return
*/
public
IssMatchRanking protoToRanking(IssMatchRankingProto issMatchRankingProto) {
IssMatchRanking issMatchRanking =
new
IssMatchRanking();
issMatchRanking.setRowNum(issMatchRankingProto.getRowNum());
issMatchRanking.setMatchUserId(issMatchRankingProto.getMatchUserId());
issMatchRanking.setGameId(issMatchRankingProto.getGameId());
issMatchRanking.setMatchId(issMatchRankingProto.getMatchId());
issMatchRanking.setUserId(issMatchRankingProto.getUserId());
issMatchRanking.setSubAccount(issMatchRankingProto.getSubAccount());
issMatchRanking.setRoleName(issMatchRankingProto.getRoleName());
issMatchRanking.setServerName(issMatchRankingProto.getServerName());
issMatchRanking.setBarName(issMatchRankingProto.getBarName());
issMatchRanking.setMatchNum(issMatchRankingProto.getMatchNum());
issMatchRanking.setKillManCnt(issMatchRankingProto.getKillManCnt());
issMatchRanking.setHurtCnt(issMatchRankingProto.getHighestWinCnt());
issMatchRanking.setHighestWinCnt(issMatchRankingProto.getHighestWinCnt());
issMatchRanking.setBattleCnt(issMatchRankingProto.getBattleCnt());
issMatchRanking.setReward(issMatchRankingProto.getReward());
issMatchRanking.setGrading(issMatchRankingProto.getGrading());
return
issMatchRanking;
}
标签:
原文地址:http://blog.csdn.net/abudexiatian/article/details/51274652