本文详细解析了SOFABolt V2通信协议的设计要点，包括请求与响应协议格式、各字段含义及作用，如协议码、版本号、请求类型等，并强调了CRC校验的重要性。
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请求协议字段的含义。
本系列文章目录：
扫一扫
990
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
