MINA经典入门例子----Time Server

原文地址 http://blog.sina.com.cn/s/blog_720bdf0501010b8r.html

貌似java的IO、NIO的入门例子都有相关的Time Server Demo。本例为MINA官方Demo翻译过来而已。

  MINA百科：

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

　　目前正在使用 MINA 的软件包括有：Apache Directory Project、AsyncWeb、AMQP（Advanced Message Queuing Protocol）、RED5 Server（Macromedia Flash Media RTMP）、ObjectRADIUS、Openfire 等等。

      目前最新版本为2.02 Release,官方网站为：http://mina.apache.org/。

      MINA框架的特点有：基于java NIO类库开发；采用非阻塞方式的异步传输；事件驱动；支持批量数据传输；支持TCP、UDP协议；控制反转的设计模式（支持Spring）；采用优雅的松耦合架构；可灵活的加载过滤器机制；单元测试更容易实现；可自定义线程的数量，以提高运行于多处理器上的性能；采用回调的方式完成调用，线程的使用更容易。 
     MINA框架的常用类 
类NioSocketAcceptor用于创建服务端监听； 
类NioSocketConnector用于创建客户端连接； 
类IoSession用来保存会话属性和发送消息； 
类IoHandlerAdapter用于定义业务逻辑，常用的方法有： 
方法 定义 
sessionCreated() 当会话创建时被触发 
sessionOpened() 当会话开始时被触发 
sessionClosed() 当会话关闭时被触发 
sessionIdle() 当会话空闲时被触发 
exceptionCaught() 当接口中其他方法抛出异常未被捕获时触发此方法 
messageRecieved() 当接收到消息后被触发 
messageSent() 当发送消息后被触发

      Time Server测试示例：

      测试环境：Eclipse，jdk1.6，所需jar包，slf4j-api-1.5.11.jar、slf4j-jdk14-1.5.2.jar、mina-core-2.0.2.jar。 
      1、服务器端：

      1）服务器Server代码：

package org.apache.mina.example.gettingstarted.timeserver;

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.session.IdleStatus;
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() );

　　// 设置buffer的长度

　　acceptor.getSessionConfig().setReadBufferSize( 2048 );

　　//设置连接超时时间
　　acceptor.getSessionConfig().setIdleTime( IdleStatus.BOTH_IDLE, 10 );

　　// 绑定端口

　　acceptor.bind( new InetSocketAddress(PORT) );
　}
}

 2）业务逻辑处理器代码：

package org.apache.mina.example.gettingstarted.timeserver;

import java.util.Date;

import org.apache.mina.core.service.IoHandlerAdapter;
import org.apache.mina.core.session.IdleStatus;
import org.apache.mina.core.session.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();

if( str.trim().equalsIgnoreCase("quit") ) {
session.close(true);
return;
}

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


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

2、客户端测试代码

1）客户端代码

package com.kdiller.mina;

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

import org.apache.mina.core.future.ConnectFuture;
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;

public class MinaTimeClient {
 public static void main(String[] args) {
  // 创建客户端连接器.
  NioSocketConnector connector = new NioSocketConnector();
  connector.getFilterChain().addLast("logger", new LoggingFilter());
  connector.getFilterChain().addLast(
    "codec",
    new ProtocolCodecFilter(new TextLineCodecFactory(Charset
      .forName("UTF-8")))); // 设置编码过滤器
  connector.setConnectTimeout(30);
  connector.setHandler(new TimeClientHandler());// 设置事件处理器
  ConnectFuture cf = connector.connect(new InetSocketAddress("127.0.0.1",
    9123));// 建立连接
  cf.awaitUninterruptibly();// 等待连接创建完成
  cf.getSession().write("hello");// 发送消息
  cf.getSession().write("quit");// 发送消息
  cf.getSession().getCloseFuture().awaitUninterruptibly();// 等待连接断开
  connector.dispose();
 }
}

2）客户端处理器

package com.kdiller.mina;

import org.apache.mina.core.service.IoHandlerAdapter;
import org.apache.mina.core.session.IdleStatus;
import org.apache.mina.core.session.IoSession;

public class TimeClientHandler extends IoHandlerAdapter {
 public TimeClientHandler() {
 }

 @Override
 public void messageReceived(IoSession session, Object message)
   throws Exception {
  System.out.println("messageReceived method was called!");
  System.out.println(message);// 显示接收到的消息
 }

 @Override
 public void exceptionCaught(IoSession session, Throwable cause)
   throws Exception {
  // TODO Auto-generated method stub
  super.exceptionCaught(session, cause);
 }

 @Override
 public void messageSent(IoSession session, Object message) throws Exception {
  // TODO Auto-generated method stub
  super.messageSent(session, message);
  System.out.println("messageSent method was called!");
  System.out.println(message);
 }

 @Override
 public void sessionClosed(IoSession session) throws Exception {
  // TODO Auto-generated method stub
  super.sessionClosed(session);
  System.out.println("sessionClosed method was called!");
 }

 @Override
 public void sessionCreated(IoSession session) throws Exception {
  // TODO Auto-generated method stub
  super.sessionCreated(session);
  System.out.println("sessionCreated method was called!");
 }

 @Override
 public void sessionIdle(IoSession session, IdleStatus status)
   throws Exception {
  // TODO Auto-generated method stub
  super.sessionIdle(session, status);
 }

 @Override
 public void sessionOpened(IoSession session) throws Exception {
  // TODO Auto-generated method stub
  super.sessionOpened(session);
  System.out.println("sessionOpened method was called!");
 }
 
}