MINA入门

1. Apache MINA 快速入门
4. 作者：终南   <li.zhongnan@hotmail.com> 
8. 1。介绍
10. Apache MINA 是一个网络应用框架，有助于用户非常方便地开发高性能、高伸缩性的网络应用。它通过Java NIO提供了一个抽象的、事件驱动的、异步的位于各种传输协议（如TCP/IP和UDP/IP）之上的API，
12. Apache MINA 通常可被称之为：
14. NIO 框架库；
15. 客户端/服务器框架库；
16. 或者一个网络socket库。
18. 然而，它所提供的功能远不止这些。
20. （以上内容大致翻译自Apache MINA网站）
22. 如期官方文档的介绍，Apache MINA 是一个网络应用程序框架，它对Java中的socket和NIO进行了有效和清晰的封装，方便开发人员开发TCP/UDP程序，从而抛开在使用原始的socket时需要考虑的各种繁杂而又烦人问题（线程、性能、会话等），把更多精力专著在应用中的业务逻辑的开发上。
24. Apache MINA 有两个主要版本：2.0 和 1.1，2.0与1.1有较大的区别，其采用java NIO进行开发，使得性能得到有效的提升，在接口方面也有不小的变化，具体信息可以参见其网站说明。
26. 下面的介绍以 Apache MINA 2.0 为例。
28. 2。软件准备
30. 要编写和运行一个基于Apache MINA 2.0的程序，需要JDK 5.0以上版本，还需要以下软件：
32. （1）MINA 2.x Core
34. 下载地址：http://mina.apache.org/downloads.html
36. （2）SLF4J 1.3.0 or greater
38. 下载地址：http://www.slf4j.org/download.html
40. 这里需要用到两个 SLF4J 的jar包：slf4j-api.jar 和 slf4j-jdk14.jar。
42. 分别解压下载的MINA 2.x Core 和SLF4J文件，找出下列jar包文件：
44. mina-core-2.0.0-M1.jar
45. slf4j-api.jar
46. slf4j-jdk14.jar
48. 3。编写一个Apache MINA 时间服务器
50. 该程序的功能非常简单，就是当客户端连接到服务器的9123端口后，程序将服务器当前的时间信息以字符串的形式发送给客户端。
52. 我们可以用Eclipse来创建编写这个程序。
54. （1）在Eclipse中创建一个Java项目，例如 TimeServerProject，然后将mina-core-2.0.0-M1.jar、slf4j-api.jar 和 slf4j-jdk14.jar这三个文件添加到项目的Libraries中。
56. （2）创建一个 MinaTimeServer 类，其内容为：
58. import java.io.IOException;
59. import java.net.InetSocketAddress;
60. import java.nio.charset.Charset;
62. import org.apache.mina.common.IdleStatus;
63. import org.apache.mina.common.IoAcceptor;
64. import org.apache.mina.filter.codec.ProtocolCodecFilter;
65. import org.apache.mina.filter.codec.textline.TextLineCodecFactory;
66. import org.apache.mina.filter.logging.LoggingFilter;
67. import org.apache.mina.transport.socket.nio.NioSocketAcceptor;
69. public class MinaTimeServer {
70. private static final int PORT = 9123;
72. public static void main(String[] args) throws IOException {
73.    IoAcceptor acceptor = new NioSocketAcceptor();
75.    acceptor.getFilterChain().addLast("logger", new LoggingFilter());
76.    acceptor.getFilterChain().addLast(
77.      "codec",
78.      new ProtocolCodecFilter(new TextLineCodecFactory(Charset
79.        .forName("UTF-8"))));
81.    acceptor.setHandler(new TimeServerHandler());
82.    acceptor.getSessionConfig().setReadBufferSize(2048);
83.    acceptor.getSessionConfig().setIdleTime(IdleStatus.BOTH_IDLE, 10);
84.    acceptor.bind(new InetSocketAddress(PORT));
85. }
86. }
89. （3）创建一个 TimeServerHandler 类，其内容为：
91. import java.util.Date;
93. import org.apache.mina.common.IdleStatus;
94. import org.apache.mina.common.IoHandlerAdapter;
95. import org.apache.mina.common.IoSession;
97. public class TimeServerHandler extends IoHandlerAdapter {
98. @Override
99. public void exceptionCaught(IoSession session, Throwable cause)
100.     throws Exception {
101.    cause.printStackTrace();
102. }
104. @Override
105. public void messageReceived(IoSession session, Object message)
106.     throws Exception {
107.    String str = message.toString();
108.    System.out.println("Message read:");
109.    System.out.println(str);
111.    Date date = new Date();
112.    session.write(date.toString());
113.    System.out.println("Message written...");
114.    session.close();
115. }
117. @Override
118. public void sessionIdle(IoSession session, IdleStatus status)
119.     throws Exception {
120.    System.out.println("IDLE " + session.getIdleCount(status));
121. }
122. }
125. （4）编译并运行MinaTimeServer类
127. （5）打开您的浏览器，在地址栏中输入 http://127.0.0.1:9123/，然后回车，你就可以看到服务器的时间显示在您的浏览器内了。同时您也可以在运行MinaTimeServer的控制台窗口中看到类似下面的信息：
129. Message read:2008-4-11 12:22:44 org.apache.mina.filter.logging.LogLevel$4 log
130. 信息: CREATED
131. 2008-4-11 12:22:44 org.apache.mina.filter.logging.LogLevel$4 log
132. 信息: OPENED
133. 2008-4-11 12:22:44 org.apache.mina.filter.logging.LogLevel$4 log
134. 信息: RECEIVED: HeapBuffer[pos=0 lim=261 cap=2048: 47 45 54 20 2F 20 48 54 54 50 2F 31 2E 31 0D 0A...]
136. GET / HTTP/1.1
137. Message written...
138. Message read:
139. Accept: */*
140. Message written...
141. Message read:
142. Accept-Language: zh-cn,en-US;q=0.5
143. Message written...
144. Message read:
145. UA-CPU: x86
146. Message written...
147. Message read:
148. Accept-Encoding: gzip, deflate
149. Message written...
150. Message read:
151. User-Agent: Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.2; .NET CLR 1.1.4322; .NET CLR 2.0.50727)
152. Message written...
153. Message read:
154. Host: 127.0.0.1:9123
155. Message written...
156. Message read:
157. Connection: Keep-Alive
158. Message written...
159. Message read:
161. Message written...
162. 2008-4-11 12:22:44 org.apache.mina.filter.logging.LogLevel$4 log
163. 信息: SENT: HeapBuffer[pos=0 lim=29 cap=30: 46 72 69 20 41 70 72 20 31 31 20 31 32 3A 32 32...]
164. 2008-4-11 12:22:44 org.apache.mina.filter.logging.LogLevel$4 log
165. 信息: SENT: HeapBuffer[pos=0 lim=0 cap=0: empty]
166. 2008-4-11 12:22:44 org.apache.mina.filter.logging.LogLevel$4 log
167. 信息: CLOSED
169. 这是程序的日志信息以及，浏览器发送过来请求的HTTP头信息。
171. （6）或者也可以通过telnet连接服务器的9123端口，连敲两次回车，就可以看到服务器发送过来的时间信息了。