NIO框架入门(二):服务端基于MINA2的UDP双向通信Demo演示

  1. 云栖社区>
  2. 博客>
  3. 正文

NIO框架入门(二):服务端基于MINA2的UDP双向通信Demo演示

jsjsjjs 2016-06-24 15:18:00 浏览469
展开阅读全文

学习交流

更多学习资料:点此进入,移动端即时通讯交流Q群:215891622

前言

NIO框架的流行,使得开发大并发、高性能的互联网服务端成为可能。这其中最流行的无非就是MINA和Netty了,MINA目前的主要版本是MINA2、而Netty的主要版本是Netty3Netty4(Netty5已经被取消开发了:详见此文)。

本文将演示的是一个基于MINA2的UDP服务端和一个标准UDP客户端(Java实现)双向通信的完整例子。

实际上,MINA2的官方代码里有完整的UDP通信Demo代码,但Demo里客户端是需要依赖MINA2的客户端库的,而如果简单地去掉MINA2的lib依赖,改为标准的Java UDP代码,则服务端和客户端的数据收发都会存在未知多余字节等。当然,本文已解决了这些问题,请继续往下阅读。

《NIO框架入门》系列文章

有关MINA和Netty的入门文章很多,但多数都是复制、粘贴的未经证实的来路不明内容,对于初次接触的人来说,一个可以运行且编码规范的Demo,显然要比各种“详解”、“深入分析”之类的要来的直接和有意义。本系列入门文章正是基于此种考虑而写,虽无精深内容,但至少希望对初次接触MINA、Netty的人有所启发,起到抛砖引玉的作用。

本文是《NIO框架入门》系列文章中的第2篇,目录如下:

NIO框架入门(一):服务端基于Netty4的UDP双向通信Demo演示》(前篇)

NIO框架入门(二):服务端基于MINA2的UDP双向通信Demo演示》(本文)

《NIO框架入门(三):iOS与MINA2、Netty4的跨平台UDP双向通信实战》

《NIO框架入门(四):Android与MINA2、Netty4的跨平台UDP双向通信实战》

本文亮点

[1] Demo中的代码源自作者的开源工程,有实用价值:

源码均修改自作者的即时通讯开源工程MobileIMSDK,只是为了方便学习理解而作了简化,有一定的实用价值;

[2] 本例中客户端UDP实现无需第3方依赖:

通常MINA或Netty的例子里,客户端也都是用的MINA或Netty的客户端lib,本文将直接使用标准UDP代码(便于跨平台实现,比如iOS平台),不依赖于第3方包;

[3] 完整可执行源码、方便学习:

完整的Demo源码,适合新手直接运行,便于学习和研究。

Demo的代码逻辑

言归正传,本文要演示的Demo包含两部分,Java UDP客户端和MINA2 UDP服务端,客户端将每隔3秒向服务端发送一条消息,而服务端在收到消息后马上回复一条消息给客户端。

也就是说,服务端和客户端都要实现消息的发送和接收,这也就实现了双向通信。如果有心的话,稍加改造,也就很容易实现一个简陋的聊天程序了。下节将将给出真正的实现代码。

补充一句,本文中的客户端代码跟系列文章中的上篇《NIO框架入门(一):服务端基于Netty4的UDP双向通信Demo演示》,用的是相同的代码,如果您正在评估MIN2和Netty4的UDP服务端区别,可对照着上篇,进行详细对照和分析哦。

MINA2服务端准备工作

[1] 第一步:下载MINA2

MINA2的官方网站是:http://mina.apache.org/,最新版本是 Mina 2.0.13,如下图:

下载MINA2

补充说明:建议2进制和源码都下载下来,2进制制包中是编译好的jar包,源码包中包含了官方的Demo源代码,需要的时候可以对照着看看,对于最佳实践来说,有一定的参考价值。

[2] 第二步:找到MINA2的核心库文件

一般情况下,只需要mina-core-2.0.13.jar包就行了,见下图:

找到MINA2的核心库文件

补充说明:因为MINA2中使用了slf日框架,需要找到相应的lib才能最终运行,具体下一段再说明。

[3] 第三步:建好MINA2的服务端Java工程,�准备开撸

个人习惯用Eclipse,你如用NetBeans或InteliJ也没问题,具体建立过程不熟练的请自行百度吧,唯一注意的是把MINA2的lib包引用进来,我的见下图:

建好MINA2的服务端Java工程

补充说明:MINA2中需要的slf日志框架的jar包,主要额外找到并导进来,不然不能最终运行哦。你也可以下载本Demo中的服务端源码,直接用就是了。

服务端代码实现

[1] 服务端主类 EchoServer.java:

简书上贴代码很恶心,源码请参考原文:http://www.52im.net/thread-373-1-1.html

补充说明:MINA2的UDP服务端看起来比Netty4的要繁琐一些(有关Netty4的UDP服务端请见:

http://www.52im.net/thread-367-1-1.html

),实际上MINA2的代码风格更符合一般程序员的编码习惯,更好懂一些,而Netty4因历经多个大版本的进化,看起来非常简洁,但实现上并没有MINA2看起来那么直观。当然,仅是个人理解,不当之外请见谅。

[2] 服务端Handler类 EchoSeverHandler.java:

简书上贴代码很恶心,源码请参考原文:http://www.52im.net/thread-373-1-1.html

[3] 重要说明

注意点1:服务端的EchoSeverHandler.java文件中,接收数据时取得文本内容的两行代码是解决无MINA2客户端依赖的关键,具体代码如下:

IoBuffer buffer =(IoBuffer) message;

String body= buffer.getString(decoder);

而官方的代码是直接:message.toString(),这会存在不能正确地解码标准Java UDP代码实现的客户端发过来的数据问题哦。

注意点2:服务端的EchoSeverHandler.java文件中,发送数据时的IoBuffer对象组织方法是解决无MINA2客户端依赖的客户端能正确接收MINA2服务端发过去的数据的关键,具体代码如下:

IoBuffer buf = IoBuffer.wrap(res);

而官方的Demo代码以及网上的各种实现更为复杂,但会导致客户端接收数据有多余字节,官方的会产生多余字节和乱码的代码如下:

IoBuffer buf =IoBuffer.allocate(res.length);

buf.setAutoExpand(true);

buf.putInt(res.length);

buf.put(res);

buf.flip();

buf.shrink();

客户端代码实现

为了让客户端代码看起来更简洁,我把Socket管理代码提炼到 LocalUDPSocketProvider类、把UDP数据监听和接收提炼到了 LocalUDPDataReciever类(实际上这两个同名类是简化自MobileIMSDK工程哦)。

[1] 客户端主类 EchoClient.java:

public class EchoClient

{

public static void main(String[] args) throws Exception

{

// 初始化本地UDP的Socket

LocalUDPSocketProvider.getInstance().initSocket();

// 启动本地UDP监听(接收数据用的)

LocalUDPDataReciever.getInstance().startup();

// 循环发送数据给服务端

while(true)

{

// 要发送的数据

String toServer = "Hi,我是客户端,我的时间戳"+System.currentTimeMillis();

byte[] soServerBytes = toServer.getBytes("UTF-8");

// 开始发送

boolean ok = UDPUtils.send(soServerBytes, soServerBytes.length);

if(ok)

Log.d("EchoClient", "发往服务端的信息已送出.");

else

Log.e("EchoClient", "发往服务端的信息没有成功发出!!!");

// 3000秒后进入下一次循环

Thread.sleep(3000);

}

}

}

补充说明:客户端代码没有使用任何依赖,纯Java UDP代码实现(如果是Andriod平台,代码也几乎不用改就能用),部分代码修改自

开源即时通讯框架 MobileIMSDK

(去掉了很多保证健壮性代码,现在看起来要简洁的多,便于初学者学习)。

[2] Socket操作类 LocalUDPSocketProvider.java:

public class LocalUDPSocketProvider

{

private static final String TAG = LocalUDPSocketProvider.class.getSimpleName();

private static LocalUDPSocketProvider instance = null;

private DatagramSocket localUDPSocket = null;

public static LocalUDPSocketProvider getInstance()

{

if (instance == null)

instance = new LocalUDPSocketProvider();

return instance;

}

public void initSocket()

{

try

{

// UDP本地监听端口(如果为0将表示由系统分配,否则使用指定端口)

this.localUDPSocket = new DatagramSocket(ConfigEntity.localUDPPort);

// 调用connect之后,每次send时DatagramPacket就不需要设计目标主机的ip和port了

// * 注意:connect方法一定要在DatagramSocket.receive()方法之前调用,

// * 不然整send数据将会被错误地阻塞。这或许是官方API的bug,也或许是调

// * 用规范就应该这样,但没有找到官方明确的说明

this.localUDPSocket.connect(

InetAddress.getByName(ConfigEntity.serverIP), ConfigEntity.serverUDPPort);

this.localUDPSocket.setReuseAddress(true);

Log.d(TAG, "new DatagramSocket()已成功完成.");

}

catch (Exception e)

{

Log.w(TAG, "localUDPSocket创建时出错,原因是:" + e.getMessage(), e);

}

}

public DatagramSocket getLocalUDPSocket()

{

return this.localUDPSocket;

}

}

[3] 数据接收类 LocalUDPDataReciever.java:

public class LocalUDPDataReciever

{

private static final String TAG = LocalUDPDataReciever.class.getSimpleName();

private static LocalUDPDataReciever instance = null;

private Thread thread = null;

public static LocalUDPDataReciever getInstance()

{

if (instance == null)

instance = new LocalUDPDataReciever();

return instance;

}

。。。。。。。。

Demo执行效果

[1] 客户端运行结果:

客户端运行结果

[2] 服务端运行结果:

服务端运行结果

补充说明:服务端的运行结果中,控制台下�每次多出的4行log输出,实际上是MINA2内部代码的debug信息,目前除非关闭整个log的输出,不然它一定会出现,希望你在运行代码时看到这莫名其妙的4行log内容,不要感到奇怪哦,这4行log大致内容如下所示:

[DEBUG] - [13:26:36.393]Event MESSAGE_RECEIVED has been fired for session 1 | (IoFilterEvent^fire:117)

[DEBUG] - [13:26:36.393]Firing a MESSAGE_SENT event for session 1 | (IoFilterEvent^fire:68)

[DEBUG] - [13:26:36.393]Event MESSAGE_SENT has been fired for session 1 | (IoFilterEvent^fire:117)

[DEBUG] - [13:26:39.393]Firing a MESSAGE_RECEIVED event for session 1 | (IoFilterEvent^fire:68)

结语

客户端代码就是标准的Java UDP代码(无MINA2的客户端依赖),看起来跟其它例子不一样的原因只是我把它提炼了一下,没本质区别。同样的代码改改也可以很好的用在Android端。实际上,上面的客户端代码就是从开源 MobileIMSDK的Java端扒出来的,有兴趣的也可以看看它的Android端Server端iOS端,简化一下可以用作你自已的各种用途。

如果你阅读过本系列的上一篇《NIO框架入门(一):服务端基于Netty4的UDP双向通信Demo演示》,应该能明显地感觉的出来MINA2的UDP服务端API接口使用要是Netty4的繁琐,而且MINA2还存在独立客户端(非依赖于MINA2客户端)实现时的多余字节和乱码问题。但个人认为MINA2的代码风格更符合一般程序员的编码习惯,更好懂一些,而Netty4因历经多个大版本的进化,虽起来非常简洁,但实现并不是那么直观。当然,至于MINA还是Netty,请客观一评估和使用,因为二者并无本质区别。

更多学习资源

[1] MINA和Netty的源码在线学习和查阅:

MINA-2.x地址是:http://docs.52im.net/extend/docs/src/mina2/

MINA-1.x地址是:http://docs.52im.net/extend/docs/src/mina1/

Netty-4.x地址是:http://docs.52im.net/extend/docs/src/netty4/

Netty-3.x地址是:http://docs.52im.net/extend/docs/src/netty3/

[2] MINA和Netty的API文档在线查阅:

MINA-2.x API文档(在线�版):http://docs.52im.net/extend/docs/api/mina2/

MINA-1.x API文档(在线�版):http://docs.52im.net/extend/docs/api/mina1/

Netty-4.x API文档(在线�版):http://docs.52im.net/extend/docs/api/netty4/

Netty-3.x API文档(在线�版):http://docs.52im.net/extend/docs/api/netty3/

[3] 更多有关NIO编程的资料:

请进入精华资料专辑:http://www.52im.net/forum.php?mod=collection&action=view&ctid=9

[4] 有关IM聊天应用、消息推送技术的资料:

请进入精华资料专辑:http://www.52im.net/forum.php?mod=collection&op=all

[5] 技术交流和学习:

可直接进入即时通讯开发者社区讨论和学习网络编程、IM聊天应用、消息推送应用的开发。

完整源码工程下载

如需完整Eclipse源码工程请联系作者,或者进入链接http://www.52im.net/thread-367-1-1.html自行下载。

完整源码工程截图如下:

img_5aec9f847b58f1c47e40b1cb6c2f6605.png
完整源码工程截图

(本文同步发布于:http://www.52im.net/thread-373-1-1.html)

作者:Jack Jiang(点击作者姓名进入Github)

出处:http://www.52im.net/thread-373-1-1.html

联系方式:QQ: 413980957, 微信: hellojackjiang,Email: jb2011@163.com

Jack Jiang同时是【原创Java Swing外观工程BeautyEye】【轻量级移动端即时通讯框架MobileIMSDK】的作者,可前往下载交流。

本文欢迎转载,转载请注明出处(也可前往我的52im.net找到我)。

网友评论

登录后评论
0/500
评论
jsjsjjs
+ 关注