SOFA BOLT源码解析之设计要点-通信协议

 

 

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请求协议字段的含义。