Go - 如何编写 ProtoBuf 插件 (一) ?
文章目录:
- 前言
- 自定义选项
- 需求场景
- 推荐阅读
前言
我们要知道 proto3
和 proto2
的语法,并不是完全兼容的。
具体可查阅官方文档:
- Overview[1]
- Language Guide (proto2)[2]
- Language Guide (proto3)[3]
如果上述链接无法打开,可以访问这个文档:Overview - 语雀[4] 。
自定义选项
在 proto3
中,常见的实现插件的方式是使用 自定义选项
,也就是 extend
标签,其中支持的 extend Options
有:
MethodOptions
ServiceOptions
EnumOptions
EnumValueOptions
MessageOptions
FieldOptions
FileOptions
OneofOptions
ExtensionRangeOptions
具体写法可参考:
import "google/protobuf/descriptor.proto";
extend google.protobuf.MessageOptions {
optional string my_option = 51234;
}
message MyMessage {
option (my_option) = "Hello world!";
}
需求场景
假设,我们的需求场景是这样的:
我们有很多的拦截器,其中不同的 service
可能会使用一个或多个拦截器,不同的 method
也可能会使用一个或多个拦截器,在 helloworld.proto
中
service Greeter{}
支持登录令牌验证rpc SayHello1()
支持IP
白名单限制和记录日志rpc SayHello2()
支持禁止记录日志
// helloworld.proto
service Greeter {
rpc SayHello1 (HelloRequest) returns (HelloReply) {}
rpc SayHello2 (HelloRequest) returns (HelloReply) {}
}
message HelloRequest {
string name = 1;
}
message HelloReply {
string message = 1;
}
我们需要在 proto
文件中,定义出 service
使用了哪些拦截器?定义出 method
使用了哪些拦截器?这样 proto
文件就会更加语义化,更加清晰明确,当大家看到定义的文件时,对使用的拦截器一目了然。
如何实现这个功能?
这时,我们就需要用到 MethodOptions
和 ServiceOptions
选项,通过名字大概也能猜到 MethodOptions
是定义方法选项的,ServiceOptions
是定义服务选项的。
extend google.protobuf.MethodOptions {
...
}
extend google.protobuf.ServiceOptions {
...
}
大家有实现的思路吗?欢迎留言评论 ~
参考资料
[1]Overview: https://developers.google.com/protocol-buffers/docs/overview
[2]Language Guide (proto2): https://developers.google.com/protocol-buffers/docs/proto
[3]Language Guide (proto3): https://developers.google.com/protocol-buffers/docs/proto3
[4]Overview - 语雀: https://www.yuque.com/xinliangnote/blog/mumt7v
相关文章
- 【技术种草】cdn+轻量服务器+hugo=让博客“云原生”一下
- CLB运维&运营最佳实践 ---访问日志大洞察
- vnc方式登陆服务器
- 轻松学排序算法:眼睛直观感受几种常用排序算法
- 十二个经典的大数据项目
- 为什么使用 CDN 内容分发网络?
- 大数据——大数据默认端口号列表
- Weld 1.1.5.Final,JSR-299 的框架
- JavaFX 2012:彻底开源
- 提升as3程序性能的十大要点
- 通过凸面几何学进行独立于边际的在线多类学习
- 利用行动影响的规律性和部分已知的模型进行离线强化学习
- ModelLight:基于模型的交通信号控制的元强化学习
- 浅谈Visual Source Safe项目分支
- 基于先验知识的递归卡尔曼滤波的代理人联合状态和输入估计
- 结合网络结构和非线性恢复来提高声誉评估的性能
- 最佳实践丨云开发CloudBase多环境管理实践
- TimeVAE:用于生成多变量时间序列的变异自动编码器
- 具有线性阈值激活的神经网络:结构和算法
- 内网渗透之横向移动 -- 从域外向域内进行密码喷洒攻击