最近使用Mina开发一个在线聊天的项目,因此也特意学习了Apache的这个Mina框架。
首先,Mina是个什么东西?看下官方网站(http://mina.apache.org/)对它的解释:
Apache的Mina(Multipurpose Infrastructure Networked Applications)是一个网络应用框架,可以帮助用户开发高性能和高扩展性的网络应用程序;它提供了一个抽象的、事件驱动的异步API,使Java NIO在各种传输协议(如TCP/IP,UDP/IP协议等)下快速高效开发。
Apache Mina也称为:
NIO框架
客户端/服务端框架(典型的C/S架构)
网络套接字(networking socket)类库
事件驱动的异步API(注意:在JDK7中也新增了异步API)
总之:我们简单理解它是一个封装底层IO操作,提供高级操作API的通讯框架!
在Mina的官网、以及网上都有比较丰富的文档了,这里我就稍微简单说一下Mina的结构和示例代码。
因为Mina2.X改进了Mina的代码结构和包结构,降低了使用的复杂性和增强了健壮性,所以使得API发生了比较大的改变,有许多地方已经和Mina1.x不兼容了。
我这里要实现的是在线聊天功能,所以其中使用的数据并不单一,所以这里采用了JOSN的数据格式,我这里是采用UTF-8的编码,代码中用到的JSON的2个处理包:json-lib-2.3-jdk15.jar、ezmorph-1.0.6.jar。
使用的Mina版本为2.0.4
具体的开发过程,比如导包和建立项目什么的我就不说了,这里直接上代码。
(1)服务端代码TcpServer
我这里使用的是Mina自带TextLineCodecFactory
packagecom.lrcx.ky.server;
importjava.io.IOException;
importjava.net.InetSocketAddress;
importjava.nio.charset.Charset;
importjava.util.concurrent.Executors;
importorg.apache.mina.core.service.IoServiceStatistics;
importorg.apache.mina.core.session.IdleStatus;
importorg.apache.mina.filter.codec.ProtocolCodecFilter;
importorg.apache.mina.filter.codec.textline.LineDelimiter;
importorg.apache.mina.filter.codec.textline.TextLineCodecFactory;
importorg.apache.mina.filter.executor.ExecutorFilter;
importorg.apache.mina.transport.socket.SocketAcceptor;
importorg.apache.mina.transport.socket.nio.NioSocketAcceptor;
publicclassTcpServer {
privateintport =8292;
privateintidleTime =1800;
privateintbufferSize =1024;
privateSocketAcceptor acceptor;
publicvoidstart() {
acceptor =newNioSocketAcceptor(Runtime.getRuntime().availableProcessors() +1);
TextLineCodecFactory lineCodec =newTextLineCodecFactory(Charset
.forName("UTF-8"), LineDelimiter.WINDOWS.getValue(),
LineDelimiter.WINDOWS.getValue());
lineCodec.setDecoderMaxLineLength(2*1024*1024);
lineCodec.setEncoderMaxLineLength(2*1024*1024);
acceptor.getFilterChain().addLast("codec",newProtocolCodecFilter(lineCodec));
acceptor.getFilterChain().addLast("exceutor",newExecutorFilter(Executors.newCachedThreadPool()));
acceptor.setHandler(newTcpHandler());
acceptor.setReuseAddress(true);
acceptor.setBacklog(10240);
acceptor.getSessionConfig().setReuseAddress(true);
acceptor.getSessionConfig().setReadBufferSize(bufferSize);
acceptor.getSessionConfig().setReceiveBufferSize(bufferSize);
acceptor.getSessionConfig().setTcpNoDelay(true);
acceptor.getSessionConfig().setSoLinger(-1);
// 单位秒
acceptor.getSessionConfig().setIdleTime(IdleStatus.BOTH_IDLE, idleTime);
try{
acceptor.bind(newInetSocketAddress(port));
}catch(IOException e) {
e.printStackTrace();
System.exit(0);
}
}
publicvoidstop() {
acceptor.dispose();
}
}
代码中的这两行:
lineCodec.setDecoderMaxLineLength(2*1024*1024);
lineCodec.setEncoderMaxLineLength(2*1024*1024);
是用来设置每次传输文本的长度的。
(2)服务端处理器代码TcpHandler
packagecom.lrcx.ky.server;
importnet.sf.json.JSONObject;
importorg.apache.mina.core.service.IoHandlerAdapter;
importorg.apache.mina.core.session.IdleStatus;
importorg.apache.mina.core.session.IoSession;
publicclassTcpHandlerextendsIoHandlerAdapter {
@Override
publicvoidmessageReceived(IoSession session, Object message)
throwsException {
JSONObject request = JSONObject.fromObject(message.toString());
// 根据传来的数据进行处理
System.out.println(request);
}
@Override
publicvoidexceptionCaught(IoSession session, Throwable cause)
throwsException {
}
@Override
publicvoidsessionClosed(IoSession session)throwsException {
}
@Override
publicvoidsessionIdle(IoSession session, IdleStatus status)
throwsException {
}
}
(3)客户端代码TcpClient
packagecom.lrcx.ky.site.client;
importjava.net.InetSocketAddress;
importjava.nio.charset.Charset;
importjava.util.concurrent.Executors;
importnet.sf.json.JSONObject;
importorg.apache.mina.core.filterchain.DefaultIoFilterChainBuilder;
importorg.apache.mina.core.future.CloseFuture;
importorg.apache.mina.core.future.ConnectFuture;
importorg.apache.mina.core.session.IoSession;
importorg.apache.mina.filter.codec.ProtocolCodecFilter;
importorg.apache.mina.filter.codec.textline.LineDelimiter;
importorg.apache.mina.filter.codec.textline.TextLineCodecFactory;
importorg.apache.mina.filter.executor.ExecutorFilter;
importorg.apache.mina.transport.socket.SocketConnector;
importorg.apache.mina.transport.socket.nio.NioSocketConnector;
publicclassTcpClient {
privateSocketConnector connector;
privateConnectFuture future;
privateIoSession session;
publicbooleanconnect() {
try{
// 创建一个socket连接
connector =newNioSocketConnector();
// 设置链接超时时间
connector.setConnectTimeoutMillis(3000);
// 获取过滤器链
DefaultIoFilterChainBuilder filterChain = connector.getFilterChain();
// 添加编码过滤器 处理乱码、编码问题
TextLineCodecFactory lineCodec =newTextLineCodecFactory(Charset.forName("UTF-8"), LineDelimiter.WINDOWS.getValue(), LineDelimiter.WINDOWS.getValue());
lineCodec.setDecoderMaxLineLength(2*1024*1024);
lineCodec.setEncoderMaxLineLength(2*1024*1024);
filterChain.addLast("codec",newProtocolCodecFilter(lineCodec));
filterChain.addLast("exceutor",newExecutorFilter(Executors.newCachedThreadPool()));
// 消息核心处理器
connector.setHandler(newTcpHandler());
// 连接服务器,知道端口、地址
future = connector.connect(newInetSocketAddress("127.0.0.1",8292));
// 等待连接创建完成
future.awaitUninterruptibly();
// 获取当前session
session = future.getSession();
returntrue;
}catch(Exception e) {
e.printStackTrace();
returnfalse;
}
}
publicvoidwrite(JSONObject request)throwsException {
session.write(request.toString());
}
publicbooleanclose() {
try{
CloseFuture future = session.getCloseFuture();
future.awaitUninterruptibly(1000);
connector.dispose();
returntrue;
}catch(Exception e) {
e.printStackTrace();
returnfalse;
}
}
}
(4)客户端处理器代码TcpHandler
packagecom.lrcx.ky.site.client;
importnet.sf.json.JSONObject;
importorg.apache.mina.core.service.IoHandlerAdapter;
importorg.apache.mina.core.session.IoSession;
publicclassTcpHandlerextendsIoHandlerAdapter {
publicvoidmessageReceived(IoSession session, Object message)throwsException {
JSONObject request = JSONObject.fromObject(message.toString());
// 根据传来的数据进行处理
System.out.println(request);
}
publicvoidexceptionCaught(IoSession session, Throwable cause)
throwsException {
}
publicvoidsessionClosed(IoSession session)throwsException {
}
}
以上是客户端和服务端通信的基础代码,具体的业务逻辑大家可以在这个基础上随意发挥。