apache mina 学习笔记之一：mina简介和环境搭建

Mina简介：

          Apache MINA(Multipurpose Infrastructure for Network Applications) 是 Apache 组织一个较新的项目，它为开发高性能和高可用性的网络应用程序提供了非常便利的框架。当前发行的 MINA 版本支持基于 Java NIO 技术的 TCP/UDP 应用程序开发、串口通讯程序（只在最新的预览版中提供），MINA 所支持的功能也在进一步的扩展中。

Apache Mina经常用作：
1）NIO框架库
2）客户端/服务器通信框架库
3）网络Socket通信库

Apache Mina还伴随有不少子项目：
1）Asyncweb
构建于Apache Mina异步框架之上的HTTP服务器
2）FtpServer
一个FTP服务器
3）SSHd
一个Java库，支持SSHH协议
4）Vysper

一个XMPP服务器

本文将通过一个简单的问候程序 HelloServer 来介绍 MINA 的基础架构的同时演示如何使用MINA 开发网络应用程序。

环境准备

1. 首先到官方网站下载最新的 MINA 版本，地址是：http://mina.apache.org/downloads.html。下载之前先介绍一下 MINA 的两个版本：1.0.x 适合运行环境为 JDK1.4，1.1.x 适合 JDK1.5 的版本，两者的编译环境都需要 JDK1.5。JDK1.5 已经是非常普遍了，本文中使用 1.1.5 版本的 MINA，编译和运行所需的文件是 mina-core-1.1.5.jar。
2. 下载 MINA 的依赖包 slf4j。MINA 使用此项目作为日志信息的输出，而 MINA 本身并不附带此项目包，请到http://www.slf4j.org/download.html地址下载 slf4j 包，slf4j 项目解压后有很多的文件，本例中只需要其中的 slf4j-api-1.4.3.jar 和 slf4j-simple-1.4.3.jar 这两个 jar 文件。如果没有这两个文件就会导致启动例子程序的时候报 org/slf4j/LoggerFactory 类没找到的错误。
3. 当然要求机器上必须装有 1.5 或者更新版本的 JDK。
4. 最好你应该选择一个顺手的 Java 开发环境例如 Eclipse 或者 NetBeans 之类的，可以更方便的编码和调试，虽然我们的最低要求只是一个简单的文本编辑器而已。

项目先决条件：

1、apache mina core 2.09.jar文件

2、Eclipse或MyEclipse或IDEA 编辑器

3、slf4j的jar文件

项目结构：

编写代码并执行

1、编写代码HelloServer.java，如下：

package demo.mina.echo;


import java.io.IOException;
import java.net.InetSocketAddress;
import java.nio.charset.Charset;
import java.text.SimpleDateFormat;
import java.util.Calendar;


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;


public class HelloServer {
    private static final int PORT = 9123;
    public static void main(String[] args){
        // 监听连接的对象
        IoAcceptor acceptor = new NioSocketAcceptor();        
        // 配置过滤器
        // logger过滤器会输出所有的信息，例如新创建的会话、消息的接收、消息的发送、会话的关闭
        // codec过滤器会转换二进制活协议规定的数据为消息对象，这里是处理基于文本的消息
        acceptor.getFilterChain().addLast("logger", new LoggingFilter());
        acceptor.getFilterChain().addLast("codec", new ProtocolCodecFilter(
                new TextLineCodecFactory(Charset.forName("UTF-8"))));
        
        // 
        acceptor.setHandler(new TimeServerHandler());        
        // 设置输入缓冲区的大小和会话的IDLE熟悉
        acceptor.getSessionConfig().setReadBufferSize(2048);
        acceptor.getSessionConfig().setIdleTime(IdleStatus.BOTH_IDLE, 10);        
        try {
            acceptor.bind(new InetSocketAddress(PORT));
            System.out.println("HelloServer started on port " + PORT);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }    
    
}
/*
 * HelloServer 处理逻辑
 *
 */
class TimeServerHandler extends IoHandlerAdapter {
<span style="white-space:pre">	</span>//当有异常发生时触发
    @Override
    public void exceptionCaught(IoSession session, Throwable cause)
            throws Exception {
        cause.printStackTrace();
        session.close();
    }
    //收到来自客户端的消息
    @Override
    public void messageReceived(IoSession session, Object message) throws Exception {
   //来至客户端信息
        String str = message.toString();
        //来至客户端ip信息
        String ip = session.getRemoteAddress().toString();
        System.out.println("===> Message From " + ip +" : " + str);    
        session.write("Hello,Client " + ip);
        //接受客户端字符串"quit"关闭当前会话连接
        if(str.trim().equalsIgnoreCase("quit")){
            session.close(true);
            return;
        }
//        Calendar time = Calendar.getInstance();
//        SimpleDateFormat df = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
//        session.write(df.format(time.getTime()));
//        System.out.println("Time Message written...");
    }
    //连接被关闭时触发
    @Override
public void sessionClosed(IoSession session) throws Exception {
// TODO Auto-generated method stub
    System.out.println("session closed from " + session.getRemoteAddress().toString());
}
    //有新连接时触发
@Override
public void sessionOpened(IoSession session) throws Exception {
// TODO Auto-generated method stub
System.out.println("session open for " + session.getRemoteAddress());
}
@Override
    public void sessionIdle(IoSession session, IdleStatus status) throws Exception {
        //System.out.println("IDLE "+session.getIdleCount(status));
    }
    
    


}

2、运行HelloServer
在命令行输入telnet 127.0.0.1 9123

服务器端的输出也可以看到：