Apache Mina开发手册之四

Apache Mina开发手册之四

一、Mina开发的主要步骤

1、创建一个实现了IoService接口的类

IoService接口有两个子接口:
1)IoAcceptor接口,用于服务器
2)IoConnection接口,用于客户端

IoService接口的目的是提供服务,有几个默认实现:
NioDatagramAcceptor、NioDatagramConnector
NioSocketAcceptor、NioSocketConnector
VmPipeAcceptor、VmPipeConnector
ProxyConnector

2、设置一个过滤器,如果需要自定义过滤器,那么此过滤器需要实现了IoFilter接口
IoFilter作用是建立一层过滤网,作用与Servlet规范中的过滤器一样。
IoFilter接口的默认实现比较多,有些仅供内部使用,有些供用户使用,而且过滤器的顺序可以影响程序的运行。常用的实现类包括:
1)ExecutorFilter:从此过滤器后的任何操作都工作于这个Executor
2)LoggingFilter:日志操作过滤器,记录日志用的
3)ProtocolCodecFilter:实现协议层和业务层的分离。
4)ProxyFilter:代理过滤器,拦截请求或响应,转发给代理。
5)SslFilter:用于SSL通信

3、创建一个实现了IoHandler接口的处理类,用于处理事件
处理业务逻辑,尤其要注意里面的IoSession接口。

4、对IoService绑定一个端口开始工作

二、Mina自定义协议

Mina中的例子:
org.apache.mina.example.chat:支持Spring、Jmx、自定义协议
org.apache.mina.example.imagine:支持Jmx、自定义协议
org.apache.mina.example.sumup:支持自定义协议
org.apache.mina.example.tapedeck:状态机的示范、自定义协议

三、协议解码器

协议解码器是依赖于ProtocolDecoder接口:

public interface ProtocolDecoder{
  // 把二进制协议或特定协议的内容解码成高级消息
  void decode(IoSession session, IoBuffer in, ProtocolDecoderOutput out);
  // 当指定的会话关闭时调用此方法
  void finishDecode(IoSession session, ProtocolDecoderOutput out);
  // 释放此解码器相关的所有资源
  void dispose(IoSession session) throws Exception;
}

由于异步的原因,传过来的IoBuffer所接受的内容是不完全确定的,也即IoBuffer中对于一次receive后,存放的不一定是一个完整的协议,有可能是多个不完整的协议,也可能刚好是一个完整的协议,这些都不确定。
基于以上情况,实际开发一般是实现CumulativeProtocolDecoder类,此抽象类的作用是为解析协议提供一些帮助,此抽象类实现了ProtocolDecoder接口中的decode接口,并抽象出一个doDecode方法。doDecode方法要求如果能解析一个协议,则把此协议解析后放入ProtocolDecoderOutput类,并返回true,反之则直接返回false,并需要手动回滚POS。


协议解码器类有两种工作方式:
1)完全交由doDecode处理
2)逻辑部分交由doDecode方法处理,IoBuffer是半自动的

四、协议编码器

协议编码器依赖于ProtocolEncoder接口。

public interface ProtocolEncoder{
  // 把高级消息对象编码成二进制或特定协议的数据
  void encode(IoSession session, Object message, ProtocolEncoderOutput out);
  // 释放此协议编码器相关的所有资源
  void dispose(IoSession session) throws Exception;
}

协议编码器可以做到全自动,因为可以一次性把所需的内容写入IoBuffer,并交给ProtocolEncoderOutput,后台会根据缓冲区的大小,能写入多少就写入多少,直到把ProtocolEncoderOutput中需要发送的协议全部发送完。

郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。