8.Utm示例-Netty集成

Utm示例-Netty集成

 

在各个平台上集成utm主要是通过一个过滤器将该平台收到的信息转发到utm里，由utm线程调度处理。

 

Netty4（4.1.0.Beta5）

一个Java写的基于NIO的客户，服务器端编程框架，这里就不介绍关于Netty的基本内容了，只是关注如何在Netty4上集成utm。（这次是本人刚接触Netty，所以可能对于其中的一些细节不甚了解，如果有什么不对的地方希望大家提出）。

测试代码中前后端交互的编码使用了 netty自带的长度LengthFieldxxx和自己定义的消息体编码CommonObjB（这里就不做详细介绍）；而客户端采用的是java写的一个简单的Socket处理（BIO），使得代码相对更加简洁易懂，而且比较容易移植到其他语言上（当然把它改成NIO是很容易的事情，不过如果只是和一个服务端通信，其实客户端并不太需要做这种改变）。

 

 

相关的代码：GitHub: https://github.com/dga4654dan/UTM-DEMO下的 V_1_0_1 下的 UtmDemo_Netty_4.1.0.Beta5

或 Git@OSC: http://git.oschina.net/daemon_c/UTM-demo下的 V_1_0_1 下的 UtmDemo_Netty_4.1.0.Beta5

 

 

 

首先在Netty的ChannelInitializer中实例化utm，对应MainHandlerInitializer类，在该类里的构造方法中实例化utm：

（如上提及的“实例化utm”）

 

 

然后是在Netty的消息控制器（MainHandler）将信息转发到utm上：

（在Netty上给定的接口是基于连接的，就是：一个连接 连接上了，连接 断开了，连接 发送来消息了，而utm也并不包含连接与用户的映射关系（在“Utm详细实现 ->用户生命流程 -> 用户登录 -> 详细流程 -> 关于为什么要有loginLinkCheck问题”中已有说明），所以这部分内容需要外围的程序实现，封装在了ControlCenter中（可以查看该具体类方法的说明和实现））

 

MainHandler：

1.连接 连接到服务端，这里utm并不做处理，只是记录连接信息（ControlCenter.visitorLink）

publicvoid channelActive(ChannelHandlerContext ctx)throws Exception {

 

//客户端连接到服务

Channelchannel = ctx.channel();

ChannelIdchannelId = channel.id();

Stringaddress = channel.remoteAddress().toString();

Stringip = address.substring(1, address.indexOf(':'));

 

//将连接信息（Link）放入到linkMap

ControlCenter.visitorLink(channelId,channel, ip);

 

super.channelActive(ctx);

}

 

 

 

 

2.连接断开，如果该连接对应一个客户，则调用utm的客户断线方法（userThreadModeFilter.disconnect）

 

publicvoid channelInactive(ChannelHandlerContext ctx)throws Exception {

 

//客户端断开连接

 

ChannelIdchannelId = ctx.channel().id();

IntegeruserId = ControlCenter.disconnect(channelId);

 

//如果是用户则调用utm的用户断线事件

if( userId !=null ) {

 

Useruser = ControlCenter.getUser( userId );

if( user !=null ) {

 

LoggerCenter.userRquestLogger.log(user.userName,

LoggerCenter.getBeforeInfo().append("cmd:netty user disconnect\n") );

 

userThreadModeFilter.disconnect(requestIds.getAndIncrement(), userId);

 

}

}

}

 

3.接收到连接的消息，如果该连接是用户则调用utm的用户cmd请求处理方法（userThreadModeFilter.handleUserRequest），如果该连接是游客则调用utm的游客cmd请求处理方法（userThreadModeFilter.handleVisitorRequest）。

 

protectedvoid channelRead0(ChannelHandlerContext ctx, ByteBuf buf)throws Exception {

 

//接收到客户端消息

ChannelIdchannelId = ctx.channel().id();

Linklink = ControlCenter.getLink(channelId);

IntegeruserId = link.getUserId();

//解析请求参数

Integercmd = cmdCoder.decoder(buf);

CommonObjBparam = decoder.decoder(buf);

 

if( userId ==null ) {

//处理游客请求

userThreadModeFilter.handleVisitorRequest(requestIds.getAndIncrement(), cmd, channelId, link.visitor, param);

 

} else {

//如果是断开，则设置连接信息（Link）为断开

if( cmd ==Cmd.Logout.CMD )

link.logout();

//处理用户请求

userThreadModeFilter.handleUserRequest(requestIds.getAndIncrement(), cmd, userId, param);

}

}

再来看下一个前后端简单的交互过程（HeartbeatHandler心跳）：

由客户端发给服务端，带有一个requestCode参数，服务端接收到并返回该参数。

 

服务端：（HeartbeatHandler）

服务端处理器只需要实现IRequestHandler接口即可，由于该接口方法较多，所以直接继承了一个实现了部分方法的实现类，通常的cmd处理器只需要继承它并实现handlerUserRequest和queueFull即可。

 

publicvoid handlerUserRequest(int requestId, User user, CommonObjB param) {

//给用户返回心跳信息

try {

//获得请求参数

int requestCode = param.getInt(Cmd.Heartbeat.REQUEST_CODE);

//给用户返回信息

CommonObjB returnObject =new CommonObjB();

returnObject.putInt(Cmd.Heartbeat._RESULT_CODE,Cmd.SuccessCode.SUCCESS);

returnObject.putInt(Cmd.Heartbeat._REQUEST_CODE, requestCode);

ControlCenter.sendToUser(Cmd.Heartbeat.CMD, returnObject,user);

 

} catch (Exception e) {

 

CommonObjB returnObject =new CommonObjB();

returnObject.putInt(Cmd.Heartbeat._RESULT_CODE,Cmd.ErroCode.UNKNOW);

ControlCenter.sendToUser(Cmd.Heartbeat.CMD, returnObject,user);

LoggerCenter.userRquestLogger.log(user.userName, e);

}

}

 

客户端：（UTM-Demo\V_1_0_1\UtmDemo_Netty_4.1.0.Beta5\UtmDemo_Netty_4.1.0.Beta5_Client 项目的ClientTest）

发送：

publicvoid sendHeartBeat(int requestCode) {

 

CommonObjB heartbeat =new CommonObjB();

heartbeat.putInt(Cmd.Heartbeat.REQUEST_CODE, requestCode);

 

client.send(Cmd.Heartbeat.CMD, heartbeat);

}

 

接收：（此处仅简单的打印出收到的信息）

publicvoid cmdResponse(Integer cmd, CommonObjB obj) {

 

System.out.println(prefix + "cmd:" + cmd + ": " + obj.toString() );

 

}

 

 

运行效果：

左边为服务端，可以看到有关资源数量的打印：原来为0，后面客户端连上后变为1

右边是客户端，可以看到

1.登录成功后服务端返回的cmd:Login，其中参数1=0（resultCode=SUCCESS）

2.客户端给后台发送心跳后后台的返回cmd:-1006(心跳)，其中参数1=0（resultCode=SUCCESS），101=n（请求参数=n）

 

也可以在服务端的用户日志中看到该用户和后台的交互日志：

 

 

 

更多细节可以查看NettyUserThreadMode_V_0.9.0 和 NettyUserThreadModeTest_V_0.9.0 的源码

 

 

 

1. Utm简介

2. Utm 模块设计

3. Utm详细实现-用户生命流程

4. Utm详细实现-用户资源管理

5.Utm线程模型

6. Utm示例-公共部分

7. Utm示例-SmartFoxServer集成

8. Utm示例-Netty集成