Apache MINA實(shí)戰(zhàn)之牛刀小試

作者：kongxx 2012-05-03 10:24:02

Apache的MINA是一個(gè)被用來(lái)構(gòu)建高性能和高可伸縮性應(yīng)用程序的網(wǎng)絡(luò)應(yīng)用框架，它提供了一套統(tǒng)一的建立在Java NIO之上的事件驅(qū)動(dòng)的異步API。

對(duì)于MINA框架的了解，MINA官方的幾篇文章是必須要看的，如下：

* Application Architecture http://mina.apache.org/mina-based-application-architecture.html

* Server Architecture http://mina.apache.org/server-architecture.html

* Client Architecture http://mina.apache.org/client-architecture.html

其中幾個(gè)主要的組件如下：

I/O Service - 用來(lái)處理I/O流，對(duì)于Server端就是IOAcceptor的實(shí)現(xiàn)類接受Client端的連接請(qǐng)求，對(duì)于Client端就是IoConnector的實(shí)現(xiàn)類來(lái)建立到Server端的連接。

I/O Filter Chain - 用來(lái)過(guò)濾或轉(zhuǎn)化數(shù)據(jù)。對(duì)于Server端和Client端來(lái)說(shuō)都是IoFilter接口的實(shí)現(xiàn)類，MINA自己內(nèi)建了很多IoFilter接口的實(shí)現(xiàn)類。具體可以參考官方文檔。

I/O Handler - 用來(lái)處理真正業(yè)務(wù)邏輯的類。對(duì)于Server端和Client端來(lái)說(shuō)都是IoHandler接口的實(shí)現(xiàn)類，通常來(lái)說(shuō)需要自己編寫。

由于Server端和Client端都是基于以上三個(gè)組件的，因此對(duì)于Server端和Client端編程來(lái)說(shuō)就都有類似的代碼結(jié)構(gòu)。

對(duì)于Server端來(lái)說(shuō)：

1. 創(chuàng)建I/O service - 這里就是創(chuàng)建IOAcceptor類監(jiān)聽端口。

2. 創(chuàng)建I/O Filter Chain - 這里就是告訴使用那些IoFilter。

3. 創(chuàng)建I/O Handler - 自己的業(yè)務(wù)邏輯。

對(duì)于Client端來(lái)說(shuō)：

1. 創(chuàng)建I/O service - 這里就是創(chuàng)建IOConnector類來(lái)建立到Server端的連接。

2. 創(chuàng)建I/O Filter Chain - 這里就是告訴使用那些IoFilter。

3. 創(chuàng)建I/O Handler - 自己的業(yè)務(wù)邏輯。

下面來(lái)通過(guò)一個(gè)例子看看MINA是怎樣工作的。由于大多數(shù)應(yīng)用都是基于TCP/IP的應(yīng)用，所以這里也就不再說(shuō)UDP/IP了。

這里我使用了Maven來(lái)創(chuàng)建了一個(gè)簡(jiǎn)單java應(yīng)用程序，具體步驟請(qǐng)參Maven的官方手冊(cè)。這里只是將我用到的maven配置文件pom.xml列出，方便下面及后續(xù)文章使用。具體pom.xml文件內(nèi)容如下：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">  
    <modelVersion>4.0.0</modelVersion>  
    <groupId>com.google.code.garbagecan.minastudy</groupId>  
    <artifactId>minastudy</artifactId>  
    <packaging>jar</packaging>  
    <version>1.0-SNAPSHOT</version>  
    <name>minastudy</name>  
    <url>http://maven.apache.org</url>  
    <dependencies>  
        <dependency>  
            <groupId>org.apache.mina</groupId>  
            <artifactId>mina-core</artifactId>  
            <version>2.0.4</version>  
        </dependency>  
        <dependency>  
            <groupId>org.apache.mina</groupId>  
            <artifactId>mina-filter-compression</artifactId>  
            <version>2.0.4</version>  
        </dependency>  
        <dependency>  
            <groupId>org.slf4j</groupId>  
            <artifactId>slf4j-api</artifactId>  
            <version>1.3.0</version>  
        </dependency>  
        <dependency>  
            <groupId>org.slf4j</groupId>  
            <artifactId>slf4j-log4j12</artifactId>  
            <version>1.3.0</version>  
        </dependency>  
    </dependencies>  
</project>

首先來(lái)看Server端的代碼

package com.google.code.garbagecan.minastudy.sample1;  
 
import java.io.IOException;  
import java.net.InetSocketAddress;  
import java.nio.charset.Charset;  
 
import org.apache.mina.core.service.IoAcceptor;  
import org.apache.mina.core.service.IoHandlerAdapter;  
import org.apache.mina.core.session.IdleStatus;  
import org.apache.mina.core.session.IoSession;  
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;  
import org.slf4j.Logger;  
import org.slf4j.LoggerFactory;  
 
public class MyServer {  
      
    private static final Logger logger = LoggerFactory.getLogger(MyServer.class);  
      
    public static void main(String[] args) {  
        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 IoHandlerAdapter() {  
              
            @Override 
            public void sessionCreated(IoSession session) throws Exception {  
            }  
              
            @Override 
            public void sessionOpened(IoSession session) throws Exception {  
            }  
 
            @Override 
            public void sessionClosed(IoSession session) throws Exception {  
            }  
 
            @Override 
            public void sessionIdle(IoSession session, IdleStatus status) throws Exception {  
            }  
 
            @Override 
            public void exceptionCaught(IoSession session, Throwable cause) throws Exception {  
                logger.error(cause.getMessage(), cause);  
                session.close(true);  
            }  
 
            @Override 
            public void messageReceived(IoSession session, Object message) throws Exception {  
                logger.info("Received message " + message);  
                session.write(message);  
            }  
 
            @Override 
            public void messageSent(IoSession session, Object message) throws Exception {  
                logger.info("Sent message " + message);  
            }  
        });  
          
        try {  
            acceptor.bind(new InetSocketAddress(10000));  
        } catch (IOException ex) {  
            logger.error(ex.getMessage(), ex);  
        }  
    }  
}

1. 首先創(chuàng)建I/O Service，這里使用的是NioSocketAcceptor類來(lái)創(chuàng)建了一個(gè)IoAcceptor實(shí)例。

2. 創(chuàng)建I/O Filter Chain，這里使用了兩個(gè)IoFilter，一個(gè)是LoggingFilter用來(lái)記錄日志和打印事件消息，另一個(gè)是ProtocolCodecFilter實(shí)例用來(lái)編碼數(shù)據(jù)，這里其實(shí)就是將傳遞的數(shù)據(jù)編碼成文本。

3. 創(chuàng)建I/O Handler，不要害怕，看起來(lái)代碼多，其實(shí)就是一個(gè)實(shí)現(xiàn)了IoHandler接口的子類，自己需要實(shí)現(xiàn)其中的一些方法，這里方法比較多，但是我在這里只實(shí)現(xiàn)了messageSent，messageReceived和exceptionCaught方法。

4. ***就是讓IoAcceptor類實(shí)例綁定端口實(shí)現(xiàn)監(jiān)聽。

#p#

下面看看Client端的代碼

package com.google.code.garbagecan.minastudy.sample1;  
 
import java.net.InetSocketAddress;  
import java.nio.charset.Charset;  
 
import org.apache.mina.core.RuntimeIoException;  
import org.apache.mina.core.future.ConnectFuture;  
import org.apache.mina.core.service.IoConnector;  
import org.apache.mina.core.service.IoHandlerAdapter;  
import org.apache.mina.core.session.IdleStatus;  
import org.apache.mina.core.session.IoSession;  
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.NioSocketConnector;  
import org.slf4j.Logger;  
import org.slf4j.LoggerFactory;  
 
public class MyClient {  
      
    private static final Logger logger = LoggerFactory.getLogger(MyClient.class);  
      
    public static void main(String[] args) {  
        IoConnector connector = new NioSocketConnector();  
        connector.setConnectTimeoutMillis(10 * 1000);  
          
        connector.getFilterChain().addLast("logger", new LoggingFilter());  
        connector.getFilterChain().addLast("codec", new ProtocolCodecFilter(new TextLineCodecFactory(Charset.forName("UTF-8"))));  
          
        connector.setHandler(new IoHandlerAdapter() {  
              
            @Override 
            public void sessionCreated(IoSession session) throws Exception {  
            }  
 
            @Override 
            public void sessionOpened(IoSession session) throws Exception {  
                for (int i = 0; i < 10; i++) {  
                    session.write("Hello user_" + i);  
                }  
                session.write("Bye");  
            }  
 
            @Override 
            public void sessionClosed(IoSession session) throws Exception {  
            }  
 
            @Override 
            public void sessionIdle(IoSession session, IdleStatus status) throws Exception {  
            }  
 
            @Override 
            public void exceptionCaught(IoSession session, Throwable cause) throws Exception {  
                logger.error(cause.getMessage(), cause);  
                session.close(true);  
            }  
 
            @Override 
            public void messageReceived(IoSession session, Object message) throws Exception {  
                logger.info("Received message " + message);  
                if (message.toString().equalsIgnoreCase("Bye")) {  
                    session.close(true);  
                }  
            }  
 
            @Override 
            public void messageSent(IoSession session, Object message) throws Exception {  
                logger.info("Sent message " + message);  
            }  
        });  
 
        IoSession session = null;  
        try {  
            ConnectFuture future = connector.connect(new InetSocketAddress("localhost", 10000));  
            future.awaitUninterruptibly();  
            session = future.getSession();  
        } catch (RuntimeIoException e) {  
            logger.error(e.getMessage(), e);  
        }  
 
        session.getCloseFuture().awaitUninterruptibly();  
        connector.dispose();  
    }  
}

1. 首先創(chuàng)建I/O Service，這里使用的是NioSocketConnector類來(lái)創(chuàng)建了一個(gè)IoConnector實(shí)例，并設(shè)置連接超時(shí)為10秒。

2. 創(chuàng)建I/O Filter Chain，和服務(wù)器端同樣設(shè)置了兩個(gè)IoFilter，一個(gè)是LoggingFilter用來(lái)記錄日志和打印事件消息，另一個(gè)是ProtocolCodecFilter實(shí)例用來(lái)編碼數(shù)據(jù)，這里其實(shí)就是將傳遞的數(shù)據(jù)編碼成文本。

3. 創(chuàng)建I/O Handler，也不要害怕，看起來(lái)代碼多，其實(shí)也是一個(gè)實(shí)現(xiàn)了IoHandler接口的子類，并且自己實(shí)現(xiàn)了sessionOpened，messageSent，messageReceived和exceptionCaught方法。實(shí)現(xiàn)sessionOpened方法是為了在建立連接后向Server端發(fā)送消息。另外看一下messageReceived方法實(shí)現(xiàn)，在接收到服務(wù)器端的消息后關(guān)閉會(huì)話。從而可以使Client程序最終能夠退出。

4. ***就是IoConnector實(shí)例類連接遠(yuǎn)端的Server。

下面測(cè)試一下上面的程序，首先運(yùn)行MyServer類，然后運(yùn)行MyClient類，就可以分別在各自的終端上看到事件日志以及發(fā)送/接收的消息了。

原文鏈接：http://blog.csdn.net/kongxx/article/details/7520259

【編輯推薦】