区分 Protobuf 3 中缺失值和默认值
来自公众号:新世界杂货铺
这两天翻了翻以前的项目,发现不同项目中关于Protobuf 3缺失值和默认值的区分居然有好几种实现。今天笔者冷饭新炒,结合项目中的实现以及切身经验共总结出如下六种方案。
增加标识字段
众所周知,在Go中数字类型的默认值为0
(这里仅以数字类型举例),这在某些场景下往往会引起一定的歧义。
以
is_show
字段为例,如果没有该字段表示不更新DB中的数据,如果有该字段且值为0
则表示更新DB中的数据为不可见,如果有该字段且值为1
则表示更新DB中的数据为可见。
上述场景中,实际要解决的问题是如何区分默认值和缺失字段。增加标识字段是通过额外增加一个字段来达到区分的目的。
例如:增加一个has_show_field
字段标识is_show
是否为有效值。如果has_show_field
为true
则is_show
为有效值,否则认为is_show
未设置值。
此方案虽然直白,但每次设置is_show
的值时还需设置has_show_field
的值,甚是麻烦故笔者十分不推荐。
字段含义和默认值区分
字段含义和默认值区分即不使用对应类型的默认值作为该字段的有效值。接着前面的例子继续描述,is_show
为1时表示展示,is_show
为2时表示不展示,其他情况则认为is_show
未设置值。
此方案笔者还是比较认可的,唯一问题就是和开发者的默认习惯略微不符。
使用oneof
oneof 的用意是达到 C 语言 union 数据类型的效果,但是诸多大佬还是发现它可以标识缺失字段。
上述proto文件生成对应go文件后,Test.St
为Status
的指针类型,故通过此方案可以区分默认值和缺失字段。但是笔者认为此方案做json序列化时十分不友好,下面是笔者的例子:
上述输出结果如下:
通过上述输出知,oneof的json.Marshal
输出结果会额外多一层,而json.Unmarshal
还会失败,因此使用oneof时需谨慎。
使用wrapper类型
这应该是google官方提出的解决方案,我们看看下面的例子:
使用此方案需要引入google/protobuf/wrappers.proto
。此方案生成对应go文件后,Test.St
也是Status
的指针类型。同样,我们也看一下它的json序列化效果:
上述输出结果如下:
和oneof方案相比wrapper方案的json反序列化是没问题的,但是json.Marshal
的输出结果也会额外多一层。另外,经笔者在本地试验,此方案无法和gogoproto
一起使用。
允许proto3使用optional
标签
前面几个方案估计在实践中还是不够尽善尽美。于是2020年5月16日protoc v3.12.0
发布,该编译器允许proto3的字段也可使用 optional
修饰。
下面看看例子:
此方案需要使用新版本的protoc
且必须使用--experimental_allow_proto3_optional
开启此特性。protoc升级教程见https://github.com/protocolbuffers/protobuf#protocol-compiler-installation。下面继续看看该方案的json序列化效果
上述输出结果如下:
据上述结果知,此方案与oneof以及wrapper方案的json序列化相比更加符合预期,同样,经笔者在本地试验,此方案无法和gogoproto
一起使用。
proto2和proto3结合使用
作为一个gogoproto
的忠实用户,笔者希望在能区分默认值和缺失值的同时还可以继续使用gogoproto
的特性。于是便产生了proto2和proto3结合使用的野路子。
需要区分缺失字段和默认值的message定义在语法为proto2的文件中,proto3通过import
导入proto2的message以达区分目的。
optional
修饰的字段在Go中会生成指针类型,因此区分缺失值和默认值就变的十分容易了。下面看看此方案的json序列化效果:
上述输出结果如下:
根据上述结果知,此方案不仅能够活用gogoproto
的各种tag,其结果也和在proto3中直接使用optional效果一致。虽然笔者已经在自己的项目中使用了此方案,但是仍然要提醒一句:“写本篇文章时,笔者特意去github看了gogoproto的发布日志,gogoproto最新一个版本发布时间为2019年10月14日
,笔者大胆预言gogoproto以后不会再更新了,所以此方案还请大家酌情使用”。
最后,衷心希望本文能够对各位读者有一定的帮助。
注:
文中笔者所用go版本为:go1.15.2
文中笔者所用protoc版本为:3.14.0
文章中所用完整例子:https://github.com/Isites/go-coder/blob/master/pbjson/main.go
版权声明: 本文为 InfoQ 作者【新世界杂货铺】的原创文章。
原文链接:【http://xie.infoq.cn/article/f836a6b2ac1ecedbb3ac56509】。未经作者许可,禁止转载。
评论