MINA框架初步使用

简单介绍：MINA框架是对java的NIO包的一个封装，简化了NIO程序开发的难度，封装了很多底层的细节，然开发者把精力集中到业务逻辑上来，最近做了一个相关的项目，为了备忘对MINA做一个总结。

下面这个start方法用来初始化MINA：

private void start(int port, WebContext ctx) 
      throws IOException, InstantiationException
        , IllegalAccessException, ClassNotFoundException {
	//初始化Acceptor
	NioSocketAcceptor acceptor = new NioSocketAcceptor(5);
	//建立线程池
	java.util.concurrent.Executor threadPool = Executors.newFixedThreadPool(1500);
	//加入过滤器（Filter）到Acceptor
	acceptor.getFilterChain().addLast("exector", new ExecutorFilter(threadPool));
	acceptor.getFilterChain().addLast("codec", new ProtocolCodecFilter(new WebDecoder()，new WebEncoder()));
    LoggingFilter filter = new LoggingFilter();
	filter.setExceptionCaughtLogLevel(LogLevel.DEBUG);
	filter.setMessageReceivedLogLevel(LogLevel.DEBUG);
	filter.setMessageSentLogLevel(LogLevel.DEBUG);
	filter.setSessionClosedLogLevel(LogLevel.DEBUG);
	filter.setSessionCreatedLogLevel(LogLevel.DEBUG);
	filter.setSessionIdleLogLevel(LogLevel.DEBUG);
	filter.setSessionOpenedLogLevel(LogLevel.DEBUG);
	acceptor.getFilterChain().addLast("logger", filter); 
	acceptor.setReuseAddress(true);//设置的是主服务监听的端口可以重用  
	acceptor.getSessionConfig().setReuseAddress(true);//设置每一个非主监听连接的端口可以重用
	acceptor.getSessionConfig().setReceiveBufferSize(1024);//设置输入缓冲区的大小
	acceptor.getSessionConfig().setSendBufferSize(10240);//设置输出缓冲区的大小
	//设置为非延迟发送，为true则不组装成大包发送，收到东西马上发出
	acceptor.getSessionConfig().setTcpNoDelay(true);
	//设置主服务监听端口的监听队列的最大值为100，如果当前已经有100个连接，再新的连接来将被服务器拒绝
	acceptor.setBacklog(100);
	acceptor.setDefaultLocalAddress(new InetSocketAddress(port));
	//加入处理器（Handler）到Acceptor
	acceptor.setHandler(new WebHandler());
	acceptor.bind();
}

 

NioSocketAcceptor是MINA的适配器，一切都是从这里开始的。MINA中有个过滤器和处理器的概念，过滤器用来过滤数据，处理器用来处理数据。具体来说MINA的处理模型就是request->过滤器A->过滤器B->处理器->过滤器B->过滤器A->response,这里的request和response类似serlvet的request和response。

acceptor.getFilterChain().addLast("exector", new ExecutorFilter(threadPool));
//加入一个线程池到适配器，这里用的是jdk自带的线程池

acceptor.getFilterChain().addLast("codec", new ProtocolCodecFilter(new WebDecoder()，new WebEncoder()));
/*这里是处理逻辑的关键部位，请求的处理都是在WebDecoder类和WebEncoder类中处理，
 * 可以明显从命名上看出来一个是用来解码，另一个是用来编码，requet过来后先进入
 * WebDecoder类(实现了ProtocolDecoder接口)进行解码处理，这里可以加入自己的逻
 * 辑把传进来的流解码成自己需要的信息。而WebEncoder类(实现了ProtocolEncoder接口)
 * 是进行编码，在这个类里面加入自己的逻辑把处理后的信息组装发送给客户端(response)。
 * 而在解码和编码过程中WebHandler(扩展了IoHandlerAdapter抽象类)起到了处理器的作用。
 */
//request->WebDecoder->WebHandler->WebEncode->response

 

现在详细描述一下request->WebDecoder->WebHandler->WebEncode->response的过程：

客户端发送一个请求到MINA服务器，这里相当于来了一个requet。请求首先来到

WebDecoder类(实现了ProtocolDecoder接口)中的 
boolean decode(IoSession session, IoBuffer in, ProtocolDecoderOutput out) throws Exception{}方法
/*
参数in：用户请求信息全存在这里，读数据就从in这里读。
参数out：用来输出处理后的数据到Filter的下一个过滤器，如果没有过滤器了就输出到WebHandler，
这里有点和servelt的过滤器类似。利用out.write(Object object);这个函数可以把数据传到下一个
Filter。我们可以自己定义一个对象，我们假设为Request，用它来传递消息，那末这里就可以写成
out.write(new RequsetMessage());如果这个方法返回false，就是说当前逻辑包还没接收完
（也就是当前的IoBuffer并没有包含足够的数据），需要再次执行decode方法（再次获取新的IoBuffer），
用来获取足够的数据。如果返回值为true就表示可以不执行decode方法了，但是要激活handler方法，
必须要调用out.write方法。

public class RequestMessage{}//这里什么也不做 

*/

然后到

WebHandler(扩展了IoHandlerAdapter抽象类)中的void messageReceived(IoSession session, Object message) throws Exception{}方法

//session中必须加入这个代码，才会激活encode方法
WriteFuture future = session.write(response);
//这个的作用是发送完毕后关闭连接，加了就是短连接，不然是长连接
future.addListener(IoFutureListener.CLOSE);

IoFutureListener里面有个operationComplete(IoFuture future)方法，当流发送完成之后才调用这个方法。

参数message：用来获取Filter传递过来的对象.
对应代码RequestMessage request = (RequestMessage) message;
参数session:用来发送数据到Filter.对应代码session.write(new ResponseMessage());

public class ResponseMessage{}//这里什么也不做,假设存放处理后的数据
注意：对于一个MINA程序而言，对于WebHandler类只生成一个对象，所以要考虑线程安全问题

然后到

WebEncoder类(实现了ProtocolEncoder接口)中的
boolean encode(IoSession session, Object message, ProtocolEncoderOutput out) throws Exception{}方法
/*
参数message：用来获取上一个Filter节点的数据或者处理器的数据（如果这个过滤器为最靠近处理器的那个）
ResponseMessage response = (ResponseMessage)message;
参数out：用来输出数据到下一个Filter节点过或者到客户端,用out.write(Object encodedMessage)把数据
发送出去，但是要注意的是，如果这个Filter下一个节点如果是客户端的话，那个这个encodedMessage数据必
须为IoBuffer类型的，可以利用IoBuffer.wrap(byte[] byteArray)这个方法来格式化输出数据
*/