Apache Mina的最简单例子

lihanchuan125

apache mina的下载地址：http://mina.apache.org/mina-project/downloads.html
1. 首先，要在classpath中配置以下的jar文件：
mina-core-2.0.7.jar
mina-example-2.0.7.jar
slf4j-api-1.6.6.jar
slf4j-log4j12-1.6.6.jar
log4j-1.2.17.jar
2. 基本要素：
1) IoFilters
2) codec: ProtocolCodecFactory
3) business logic: IoHandler
2. 基于TCP的服务例子：
1） 服务Server端
定义Server服务的代码

public class DemoTimeServer {
/**
* @param args
* @throws IOException
*/
public static void main(String[] args) throws IOException {
final int PORT = 9123;
// 定义一个接收客户端请求的Acceptor
IoAcceptor acceptor = new NioSocketAcceptor();
// 1. 定义Logging的IoFilters
acceptor.getFilterChain().addLast("logger", new LoggingFilter());
// 2. 定义解析器的IoFilters，将客户端传入的流或协议数据按照定义的解析器进行解析
acceptor.getFilterChain().addLast("codec",new ProtocolCodecFilter(new TextLineCodecFactory(Charset.forName("utf-8"))));
// 3. 设置业务处理机制，定义接收连接后的信息接收，信息回复的处理方法
acceptor.setHandler(new DemoTimeServerHandler());
//NioSocketAcceptor配置acceptor.getSessionConfig().setReadBufferSize(2048);
acceptor.getSessionConfig().setIdleTime(IdleStatus.BOTH_IDLE, 10);
//定义完成，绑定端口
acceptor.bind(new InetSocketAddress(PORT));
}
}


定义处理Server端业务逻辑的代码

public class DemoTimeServerHandler implements IoHandler {
@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();
str = str + ", receiving date(" + date.toString() + ")";
session.write(str);
System.out.println("message write..." + str + ", writing date(" + date.toString());
}
@Override
public void messageSent(IoSession session, Object message) throws Exception {
String str = message.toString();
System.out.println("message sent..." + str);
}
@Override
public void sessionClosed(IoSession session) throws Exception {
System.out.println("CLOSED " + session.getReadMessages());
}
@Override
public void sessionCreated(IoSession session) throws Exception {
System.out.println("CREATED " + session.getCreationTime());
}
@Override
public void sessionIdle(IoSession session, IdleStatus status) throws Exception {
System.out.println("IDEL " + session.getIdleCount(status));
}
@Override
public void sessionOpened(IoSession arg0) throws Exception {
// TODO Auto-generated method stub
}
}


2） 客户Client端
定义客户端链接服务端的代码

public class DemoTimeClient {
/**
* @param args
* @throws InterruptedException
*/
public static void main(String[] args) throws InterruptedException {
// 创建一个客户端连接
NioSocketConnector connector = new NioSocketConnector();
//1. 定义Logging的 IoFilters
connector.getFilterChain().addLast("logger", new LoggingFilter());
// 2.定义解析器的IoFilters,将发出的信息按照定义的解析器进行解析
connector.getFilterChain().addLast("codec",new ProtocolCodecFilter(new TextLineCodecFactory(Charset.forName("utf-8"))));
// 3.设置业务处理机制，定义链接后的信息发送，接收回复信息的处理方法
DemoTimeClientHandler handler = new DemoTimeClientHandler("i am jeanjeanfang, hello dear!");
connector.setHandler(handler);
// 4. 链接服务端
IoSession session;
for (;;) {
try {
ConnectFuture future = connector.connect(new InetSocketAddress("localhost", 9123));
future.awaitUninterruptibly();
session = future.getSession();
break;
} catch (RuntimeIoException e) {
System.err.println("Failed to connect.");
e.printStackTrace();
Thread.sleep(5000);
}
}
// wait until the summation is done
session.getCloseFuture().awaitUninterruptibly();
connector.dispose();
}
}


定义客户端和服务端链接后的业务代码

public class DemoTimeClientHandler extends IoHandlerAdapter {
private String message;
public DemoTimeClientHandler(String message){
this.message = message;
}
// 接收服务端的回复信息
@Override
public void messageReceived(IoSession session, Object message)
throws Exception {
System.out.println("message received..."  + message.toString());
session.close(true);
}
// 打开连接后，将数据发送到服务端
@Override
public void sessionOpened(IoSession session) throws Exception {
System.out.println("session opened");
session.write(message);
}
@Override
public void exceptionCaught(IoSession session, Throwable cause)
throws Exception {
System.out.println("exception caught and close session");
session.close(true);
}
}


关于IoHandler(摘录自其它资料)
IoHandlerAdpater:
它只是提供了IoHandler中定义的方法体，没有任何的逻辑处理，你可以根据你自己的需求重写该类中的相关方法。这个类在实际的开发中使用的是较多的。我们上面写的例子都是继承于这个类来实现的。
SingleSessionIoHandlerDelegate:
这是一个服务器和客户端只有一个会话时使用的类，在该类的方法中没有提供session的参数，该类在实际的开发中使用的较少，如果需要对该类进行更深入的了解，请参考Mina 1.1.7的API文档。
在Mina提供的IoHandler的具体实现中，大部分的实现类都是继承与IoHandlerApater，IoHandlerAdpater在Mina 1.1.7中的子类有三个：
ChainedIoHandler:这个类主要是用于处理IoHandler的messageReceived事件，它和IoHandlerChain配合使用。当在业务逻辑中有多个IoHandler需要处理时，你可以将你的每个IoHandler添加到IoHandlerChain中，这个和过滤器
链比较相似，关于IoFilter和IoHandlerChain的具体用法和区别会在后续的文档中给出。
StreamIoHandler:该类也是用于处理IoHandler的messageReceived事件，它主要用于文件传输的系统中，比如FTP服务器中，如果需要对该类进行更深入的了解，请参考Mina 1.1.7的API文档。
DemuxingIoHandler:该类主要是用于处理多个IoHandler的messageReceived，由于在TCP/IP协议的数据传输中会出现数据的截断现象(由于socket传输的数据包的长度是固定的，当数据包大于该长度，数据包就会被截断)，所以提供这个类主要是保证IoHandler所处理的数据包的完整性，这个和编解码器中的CumulativeProtocolDecoder类似，关于这两个类的具体介绍会在后续的文档中给出。