1 设计要点解析
1.1 通信协议
SOFA Bolt定义了两个版本的私有通信协议,即V1版和V2版。
此处以V2版为例,详细描述一下私有通信协议的设计。
一、 RpcProctocolV2请求协议格式如下:
RpcProctocolV2请求协议字段:
1. proto:协议码ProtocolCode。如果一个端口,需要处理多种协议的请求,那么这个字段是必须的,根据ProtocolCode来选择不同的核心编解码器。
2. ver1:协议版本号ProtocolVersion。确定了某一种通信协议后,还需要考虑协议的微小调整需求,因此需要增加一个 version 的字段,方便在协议上追加新的字段。
3. type:请求类型RequestType,例如:request,response,oneway;
4. cmdcode:请求命令类型CommandCode,比如request可以分为:负载请求,或者心跳请求。oneway 之所以需要单独设置,是因为在处理响应时,需要做特殊判断,来控制响应是否回传。
5. ver2:请求命令版本号CommandVersion。该字段用来区分请求命令的不同版本。如果修改 Command 版本,不修改协议,那么就是纯粹代码重构的需求;除此情况,Command的版本升级,往往会同步做协议的升级。
6. requestId:请求ID,该字段主要用于异步请求时,保留请求存根使用,便于响应回来时触发回调。另外,在日志打印与问题调试时,也需要该字段。
7. codec:序列化器。该字段用于保存在做业务的序列化时,使用的是哪种序列化器。通信框架不限定序列化方式,可以方便的扩展。
8. switch:协议开关,用于一些协议级别的开关控制,比如 CRC 校验,安全校验等。
9. timeout:超时字段,客户端发起请求时,所设置的超时时间。
10. classLen :业务请求类名长度。
11. headerLen :业务请求头长度。
12. contentLen :业务请求体长度。
13. className :业务请求类名。需要注意类名传输的时候,务必指定字符集,不要依赖系统的默认字符集。曾经线上的机器,因为运维误操作,默认的字符集被修改,导致字符的传输出现编解码问题。
14. headerContent :业务请求头。
15. bodyContent :业务请求体。
16. CRC32 :CRC校验码,这也是通信场景里必不可少的一部分,而我们金融业务属性的特征,这个显得尤为重要。
二、 RpcProctocolV2响应协议格式如下:
在RpcProctocolV2响应协议字段中,除了响应码respstatus以外,其它同RpcProctocolV2请求协议字段的含义。
本系列文章目录: