Missian指南一：通信协议

Missian同时支持HTTP/TCP，也同时支持同步和异步。

 

一、同步+HTTP时的协议

这时和Hessian的协议一致。即采用POST发送数据，整个数据包（除了HTTP协议头外的数据）会交给Hessian的序列化机制来编码和解码。请求和响应中都支持chunk，编码解码过程中已经兼容。

 

二、异步+HTTP时的协议

其实和同步请求的协议相比，只是在HTTP Header中加了一些自动以的协议头。

 

1、请求

 

在HTTP头中加了一个自定义的Header：Missian-Async: true

服务器接收到这个请求之后，会将这个请求当作异步请求来处理

 

2、响应

 

在HTTP头中加了以下几个自定义的Header：

Missian-Async: true

Missian-Bean: beanName

Missian-Method: methodName

 

beanName和methodName是异步的关键，missian根据这两个去寻找回调对象（Callback）。

 

注意beanName是从请求的URL中获取的，比如http://missian.com:8080/abc/hello这个url，missian会将“abc/hello”作为beanName。这个是Hessian中没有的概念。

 

methodName是进行调用的方法名，Hessian是分装在比较底层的，为了取到这个methodName，不得已改了一点Hessian的代码。

 

三、同步+TCP时的协议

 

1、不定长数据格式

比如beanName、methodName、消息体，它们的长度不是固定的，因此在传输它们之前用4个字节表示他们的长度。其实对于beanName和methodName，可能用一个字节就足够表示了，但为了扩展性，也不省这么几个字节了。

2、字符串编码格式

在真个协议头的编码过程中都使用ASCII编码。

 

3、请求

 

|<---1字节------>|<---4+n字节--->| <--4+n字节-------->|

| 异步/同步标志位 |   beanName    |  body                    |

 

注意首字节是一个标志位，接着传了一个beanName（由4个字节的长度和其真正的内容组成），接下来就是Body极其长度了：长度用于方便missian去读取足够的数据，而body读取完成之后将会交给Hessian去处理，这个和基于HTTP时POST过来的数据是完全一样的。

 

4、响应

|<---1字节------>|<---4+n字节--->| 

| 异步/同步标志位 |   body             |

 

首字节是一个同步异步的标志位。接下来是内容极其长度。

 

四、异步+TCP时的协议

 

1、请求

 

|<---1字节------>|<---4+n字节--->| <--4+n字节-------->|

| 异步/同步标志位 |   beanName    |  body                    |

 

注 意首字节是一个标志位，接着传了一个beanName（由4个字节的长度和其真正的内容组成），接下来就是Body极其长度了：长度用于方便 missian去读取足够的数据，而body读取完成之后将会交给Hessian去处理，这个和基于HTTP时POST过来的数据是完全一样的。

 

2、响应

|<---1字节------>|<---4+n字节--->|<---4+n字节--->| <--4+n字节-------->|

| 异步/同步标志位 |   beanName    |   methodName|  body                    |

 

首字节是一个同步异步的标志位。接下来是beanName和methodName，和HTTP中一样，这两个是实现异步回调的关键。body和同步操作中时是一模一样的。

 

五、URL格式说明

AsyncMissianProxyFactory和SyncMissianProxyFactory在创建Stub时，接受的参数格式和Hessian是一样的：一个接口（将为这个接口创建代理类）和一个URL（用于表明将数据用何种方式发给那个服务器）。

 

Missian接受两种协议的URL：

1、HTTP协议：例如，http://abc.com:8080/abc，http://abc.com:8080/abc/a，http://abc.com/abc

2、TCP协议：例如，tcp://abc.com:8080/abc，tcp://abc.com:8080/abc/a，tcp://abc.com/abc

 

一个URL由4部分组成：协议、服务器地址、端口和BeanName组成。

协议 ：只能是http或者tcp，其它字符串不能接受，会抛出异常

服务器地址 ：域名和IP都可以使用

端口 ：和服务器地址之间用冒号分割，端口可以使用缺省值80（在missian中，http和tcp都是使用80作为默认端口）。

beanName ：在服务器地址和端口之后紧跟了一个'/'，这个'/'之后的全部字符串在messian中被称为beanName（不含第一个斜杠）

评论

1 楼 zhangchen 2012-04-07  

原来是老丁的大作，支持下！