Apache MINA 快速入門

Apache MINA 快速入門

 

作者：終南   <[email protected]>

 

 

 

1。介紹

 

Apache MINA 是一個網絡應用框架，有助於用戶非常方便地開發高性能、高伸縮性的網絡應用。它通過Java NIO提供了一個抽象的、事件驅動的、異步的位於各種傳輸協議（如TCP/IP和UDP/IP）之上的API，

 

Apache MINA 通常可被稱之爲：

 

NIO 框架庫；
客戶端/服務器框架庫；
或者一個網絡socket庫。

 

然而，它所提供的功能遠不止這些。

 

（以上內容大致翻譯自Apache MINA網站）

 

如期官方文檔的介紹，Apache MINA 是一個網絡應用程序框架，它對Java中的socket和NIO進行了有效和清晰的封裝，方便開發人員開發TCP/UDP程序，從而拋開在使用原始的socket時需要考慮的各種繁雜而又煩人問題（線程、性能、會話等），把更多精力專著在應用中的業務邏輯的開發上。

 

Apache MINA 有兩個主要版本：2.0 和 1.1，2.0與1.1有較大的區別，其採用java NIO進行開發，使得性能得到有效的提升，在接口方面也有不小的變化，具體信息可以參見其網站說明。

 

下面的介紹以 Apache MINA 2.0 爲例。

 

2。軟件準備

 

要編寫和運行一個基於Apache MINA 2.0的程序，需要JDK 5.0以上版本，還需要以下軟件：

 

（1）MINA 2.x Core

 

下載地址：http://mina.apache.org/downloads.html

 

（2）SLF4J 1.3.0 or greater

 

下載地址：http://www.slf4j.org/download.html

 

這裏需要用到兩個 SLF4J 的jar包：slf4j-api.jar 和 slf4j-jdk14.jar。

 

分別解壓下載的MINA 2.x Core 和SLF4J文件，找出下列jar包文件：

 

mina-core-2.0.0-M1.jar
slf4j-api.jar
slf4j-jdk14.jar

 

3。編寫一個Apache MINA 時間服務器

 

該程序的功能非常簡單，就是當客戶端連接到服務器的9123端口後，程序將服務器當前的時間信息以字符串的形式發送給客戶端。

 

我們可以用Eclipse來創建編寫這個程序。

 

（1）在Eclipse中創建一個Java項目，例如 TimeServerProject，然後將mina-core-2.0.0-M1.jar、slf4j-api.jar 和 slf4j-jdk14.jar這三個文件添加到項目的Libraries中。

 

（2）創建一個 MinaTimeServer 類，其內容爲：

 

import java.io.IOException;
import java.net.InetSocketAddress;
import java.nio.charset.Charset;

 

import org.apache.mina.common.IdleStatus;
import org.apache.mina.common.IoAcceptor;
import org.apache.mina.filter.codec.ProtocolCodecFilter;
import org.apache.mina.filter.codec.textline.TextLineCodecFactory;
import org.apache.mina.filter.logging.LoggingFilter;
import org.apache.mina.transport.socket.nio.NioSocketAcceptor;

 

public class MinaTimeServer {
private static final int PORT = 9123;

 

public static void main(String[] args) throws IOException {
   IoAcceptor acceptor = new NioSocketAcceptor();

 

   acceptor.getFilterChain().addLast("logger", new LoggingFilter());
   acceptor.getFilterChain().addLast(
     "codec",
     new ProtocolCodecFilter(new TextLineCodecFactory(Charset
       .forName("UTF-8"))));

 

   acceptor.setHandler(new TimeServerHandler());
   acceptor.getSessionConfig().setReadBufferSize(2048);
   acceptor.getSessionConfig().setIdleTime(IdleStatus.BOTH_IDLE, 10);
   acceptor.bind(new InetSocketAddress(PORT));
}
}

 

（3）創建一個 TimeServerHandler 類，其內容爲：

 

import java.util.Date;

 

import org.apache.mina.common.IdleStatus;
import org.apache.mina.common.IoHandlerAdapter;
import org.apache.mina.common.IoSession;

 

public class TimeServerHandler extends IoHandlerAdapter {
@Override
public void exceptionCaught(IoSession session, Throwable cause)
    throws Exception {
   cause.printStackTrace();
}

 

@Override
public void messageReceived(IoSession session, Object message)
    throws Exception {
   String str = message.toString();
   System.out.println("Message read:");
   System.out.println(str);

 

   Date date = new Date();
   session.write(date.toString());
   System.out.println("Message written...");
   session.close();
}

 

@Override
public void sessionIdle(IoSession session, IdleStatus status)
    throws Exception {
   System.out.println("IDLE " + session.getIdleCount(status));
}
}

 

（4）編譯並運行MinaTimeServer類

 

（5）打開您的瀏覽器，在地址欄中輸入 http://127.0.0.1:9123/，然後回車，你就可以看到服務器的時間顯示在您的瀏覽器內了。同時您也可以在運行MinaTimeServer的控制檯窗口中看到類似下面的信息：

 

Message read:2008-4-11 12:22:44 org.apache.mina.filter.logging.LogLevel$4 log
信息: CREATED
2008-4-11 12:22:44 org.apache.mina.filter.logging.LogLevel$4 log
信息: OPENED
2008-4-11 12:22:44 org.apache.mina.filter.logging.LogLevel$4 log
信息: RECEIVED: HeapBuffer[pos=0 lim=261 cap=2048: 47 45 54 20 2F 20 48 54 54 50 2F 31 2E 31 0D 0A...]

 

GET / HTTP/1.1
Message written...
Message read:
Accept: */*
Message written...
Message read:
Accept-Language: zh-cn,en-US;q=0.5
Message written...
Message read:
UA-CPU: x86
Message written...
Message read:
Accept-Encoding: gzip, deflate
Message written...
Message read:
User-Agent: Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.2; .NET CLR 1.1.4322; .NET CLR 2.0.50727)
Message written...
Message read:
Host: 127.0.0.1:9123
Message written...
Message read:
Connection: Keep-Alive
Message written...
Message read:

 

Message written...
2008-4-11 12:22:44 org.apache.mina.filter.logging.LogLevel$4 log
信息: SENT: HeapBuffer[pos=0 lim=29 cap=30: 46 72 69 20 41 70 72 20 31 31 20 31 32 3A 32 32...]
2008-4-11 12:22:44 org.apache.mina.filter.logging.LogLevel$4 log
信息: SENT: HeapBuffer[pos=0 lim=0 cap=0: empty]
2008-4-11 12:22:44 org.apache.mina.filter.logging.LogLevel$4 log
信息: CLOSED

 

這是程序的日誌信息以及，瀏覽器發送過來請求的HTTP頭信息。

 

（6）或者也可以通過telnet連接服務器的9123端口，連敲兩次回車，就可以看到服務器發送過來的時間信息了。