Apache Mina Server 2.0 中文参考手册【笔记】

Mina 同时提供了网络通信的Server 端、Client 端的封装，无论是哪端，Mina 在整个网通

通信结构中都处于如下的位置：

可见Mina 的API 将真正的网络通信与我们的应用程序隔离开来，你只需要关心你要发送、
接收的数据以及你的业务逻辑即可。
同样的，无论是哪端，Mina 的执行流程如下所示：

(1.) IoService：这个接口在一个线程上负责套接字的建立，拥有自己的Selector，监
听是否有连接被建立。

(2.) IoProcessor：这个接口在另一个线程上负责检查是否有数据在通道上读写，也就是
说它也拥有自己的Selector，这是与我们使用JAVA NIO 编码时的一个不同之处，
通常在JAVA NIO 编码中，我们都是使用一个Selector，也就是不区分IoService
与IoProcessor 两个功能接口。另外，IoProcessor 负责调用注册在IoService 上
的过滤器，并在过滤器链之后调用IoHandler。
(3.) IoFilter：这个接口定义一组拦截器，这些拦截器可以包括日志输出、黑名单过滤、
数据的编码（write 方向）与解码（read 方向）等功能，其中数据的encode 与decode
是最为重要的、也是你在使用Mina 时最主要关注的地方。
(4.) IoHandler：这个接口负责编写业务逻辑，也就是接收、发送数据的地方。

--------------------------------------------------------------------------------------------------------------------

1. 简单的TCPServer：
(1.) 第一步：编写IoService
按照上面的执行流程，我们首先需要编写IoService，IoService 本身既是服务端，又是客
户端，我们这里编写服务端，所以使用IoAcceptor 实现，由于IoAcceptor 是与协议无关的，
因为我们要编写TCPServer，所以我们使用IoAcceptor 的实现NioSocketAcceptor，实际上
底层就是调用java.nio.channels.ServerSocketChannel 类。当然，如果你使用了Apache 的
APR 库，那么你可以选择使用AprSocketAcceptor 作为TCPServer 的实现，据传说Apache APR
库的性能比JVM 自带的本地库高出很多。
那么IoProcessor 是由指定的IoService 内部创建并调用的，我们并不需要关心。

public class MyServer {

	public static void main(String[] args) throws IOException{
	IoAcceptor acceptor=new NioSocketAcceptor();
	acceptor.getSessionConfig().setReadBufferSize(2048);
	acceptor.getSessionConfig().setIdleTime(IdleStatus.BOTH_IDLE,10);
	acceptor.bind(new InetSocketAddress(9123));
	}	
}

(2.) 第二步：编写过滤器
这里我们处理最简单的字符串传输，Mina 已经为我们提供了TextLineCodecFactory 编解码
器工厂来对字符串进行编解码处理。

acceptor.getFilterChain().addLast("codec",
new ProtocolCodecFilter(
new TextLineCodecFactory(
Charset.forName("UTF-8"),
LineDelimeter.WINDOWS.getValue(),
LineDelimiter. WINDOWS.getValue()
))
);

这段代码要在acceptor.bind()方法之前执行，因为绑定套接字之后就不能再做这些准备工
作了。
这里先不用清楚编解码器是如何工作的，这个是后面重点说明的内容，这里你只需要清楚，
我们传输的以换行符为标识的数据，所以使用了Mina 自带的换行符编解码器工厂。

(3.) 第三步：编写IoHandler
这里我们只是简单的打印Client 传说过来的数据。

public class MyIoHandler extends IoHandlerAdapter {

	// 这里我们使用的SLF4J作为日志门面，至于为什么在后面说明。
	private final static Logger log = LoggerFactory
			.getLogger(MyIoHandler.class);

	@Override
	public void messageReceived(IoSession session, Object message)
			throws Exception {
		String str = message.toString();
		log.info("The message received is [" + str + "]");
		if (str.endsWith("quit")) {
			session.close(true);
			return;
		}
	}
}

然后我们把这个IoHandler 注册到IoService：
acceptor.setHandler(new MyIoHandler());
当然这段代码也要在acceptor.bind()方法之前执行。
然后我们运行MyServer 中的main 方法，你可以看到控制台一直处于阻塞状态，此时，我们
用telnet 127.0.0.1 9123 访问，然后输入一些内容，当按下回车键，你会发现数据在
Server 端被输出，但要注意不要输入中文，因为Windows 的命令行窗口不会对传输的数据
进行UTF-8 编码。当输入quit 结尾的字符串时，连接被断开。
这里注意你如果使用的操作系统，或者使用的Telnet 软件的换行符是什么，如果不清楚，
可以删掉第二步中的两个红色的参数，使用TextLineCodec 内部的自动识别机制。

2. 简单的TCPClient：
这里我们实现Mina 中的TCPClient，因为前面说过无论是Server 端还是Client 端，在Mina
中的执行流程都是一样的。唯一不同的就是IoService 的Client 端实现是IoConnector。

(1.) 第一步：编写IoService并注册过滤器：

public class MyClinet {

	/**
	 * @param args
	 */
	public static void main(String[] args) {
		// TODO Auto-generated method stub
		IoConnector connector = new NioSocketConnector();
		connector.setConnectTimeoutMillis(30000);
		connector.getFilterChain().addLast(
				"codec",
				new ProtocolCodecFilter(new TextLineCodecFactory(Charset
						.forName("UTF-8"), LineDelimiter.WINDOWS.getValue(),
						LineDelimiter.WINDOWS.getValue())));
		connector.setHandler(new ClientHandler("你好！\r\n 大家好！"));
		connector.connect(new InetSocketAddress("localhost", 9123));
	}

}

(2.) 第三步：编写IoHandler：

public class ClientHandler extends IoHandlerAdapter {
	private final static Logger LOGGER = LoggerFactory
			.getLogger(ClientHandler.class);
	private final String values;

	public ClientHandler(String values) {
		this.values = values;
	}

	@Override
	public void sessionOpened(IoSession session) {
		session.write(values);
	}
}

注册IoHandler：
connector.setHandler(new ClientHandler("你好！\r\n 大家好！"));
然后我们运行MyClient，你会发现MyServer 输出如下语句：
The message received is [你好！]
The message received is [大家好！]
我们看到服务端是按照收到两条消息输出的，因为我们用的编解码器是以换行符判断数据是否读取完毕的。