Netty是一个异步基于事件驱动的高性能网络通信框架,可以看做是对NIO和BIO的封装,并提供了简单易用的API、Handler和工具类等,用以快速开发高性能、高可靠性的网络服务端和客户端程序。
1. 创建服务端
服务端启动需要创建 ServerBootstrap
对象,并完成初始化线程模型,配置IO模型和添加业务处理逻辑(Handler)。在添加业务处理逻辑时,调用的是 childHandler()
方法添加了一个 ChannelInitializer
,代码示例如下
// 负责服务端的启动
ServerBootstrap serverBootstrap = new ServerBootstrap();
// 以下两个对象可以看做是两个线程组
// boss线程组负责监听端口,接受新的连接
NioEventLoopGroup boss = new NioEventLoopGroup();
// worker线程组负责读取数据
NioEventLoopGroup worker = new NioEventLoopGroup();
// 配置线程组并指定NIO模型
serverBootstrap.group(boss, worker).channel(NioServerSocketChannel.class)
// 定义后续每个 新连接 的读写业务逻辑
.childHandler(new ChannelInitializer<NioSocketChannel>() {
@Override
protected void initChannel(NioSocketChannel nioSocketChannel) throws Exception {
nioSocketChannel.pipeline()
// 添加业务处理逻辑
.addLast(new SimpleChannelInboundHandler<String>() {
@Override
protected void channelRead0(ChannelHandlerContext channelHandlerContext, String msg) throws Exception {
System.out.println(msg);
}
});
}
});
// 绑定端口号
serverBootstrap.bind(2002);
复制代码
通过调用 .channel(NioServerSocketChannel.class)
方法指定 Channel
类型为NIO类型,如果要指定为BIO类型,参数改成 OioServerSocketChannel.class
即可。
其中 nioSocketChannel.pipeline()
用来获取 PipeLine
对象,调用方法 addLast()
添加必要的业务处理逻辑,这里采用的是责任链模式,会将每个Handler作为一个节点进行处理。
1.1 创建客户端
客户端与服务端启动类似,不同的是,客户端需要创建 Bootstrap
对象来启动,并指定一个客户端线程组,相同的是都需要完成初始化线程模型,配置IO模型和添加业务处理逻辑(Handler), 代码示例如下
// 负责客户端的启动
Bootstrap bootstrap = new Bootstrap();
// 客户端的线程模型
NioEventLoopGroup group = new NioEventLoopGroup();
// 指定线程组和NIO模型
bootstrap.group(group).channel(NioSocketChannel.class)
// handler() 方法封装业务处理逻辑
.handler(new ChannelInitializer<Channel>() {
@Override
protected void initChannel(Channel channel) throws Exception {
channel.pipeline()
// 添加业务处理逻辑
.addLast(new SimpleChannelInboundHandler<String>() {
@Override
protected void channelRead0(ChannelHandlerContext channelHandlerContext, String msg) throws Exception {
System.out.println(msg);
}
});
}
});
// 连接服务端IP和端口
bootstrap.connect("127.0.0.1", 2002);
复制代码
(注意:下文中内容均以服务端代码示例为准)
2. 编码和解码
客户端与服务端进行通信,通信的消息是以二进制字节流的形式通过 Channel
进行传递的,所以当我们在客户端封装好Java业务对象后, 需要将其按照协议转换成字节数组,并且当服务端接受到该二进制字节流时,需要将其根据协议再次解码成Java业务对象进行逻辑处理, 这就是编码和解码的过程。Netty 为我们提供了 MessageToByteEncoder
用于编码,ByteToMessageDecoder
用于解码。
2.1 MessageToByteEncoder
用于将Java对象编码成字节数组并写入 ByteBuf
,代码示例如下
public class TcpEncoder extends MessageToByteEncoder<Message> {
/**
* 序列化器
*/
private final Serializer serializer;
public TcpEncoder(Serializer serializer) {
this.serializer = serializer;
}
/**
* 编码的执行逻辑
*
* @param message 需要被编码的消息对象
* @param byteBuf 将字节数组写入ByteBuf
*/
@Override
protected void encode(ChannelHandlerContext channelHandlerContext, Message message, ByteBuf byteBuf) throws Exception {
// 通过自定义的序列化器将对象转换成字节数组
byte[] bytes = serializer.serialize(message);
// 将字节数组写入 ByteBuf 便完成了对象的编码流程
byteBuf.writeBytes(bytes);
}
}
复制代码
2.2 ByteToMessageDecoder
它用于将接收到的二进制数据流解码成Java对象,与上述代码类似,只不过是将该过程反过来了而已,代码示例如下
public class TcpDecoder extends ByteToMessageDecoder {
/**
* 序列化器
*/
private final Serializer serializer;
public TcpDecoder(Serializer serializer) {
this.serializer = serializer;
}
/**
* 解码的执行逻辑
*
* @param byteBuf 接收到的ByteBuf对象
* @param list 任何完成解码的Java对象添加到该List中即可
*/
@Override
protected void decode(ChannelHandlerContext ctx, ByteBuf byteBuf, List<Object> list) throws Exception {
// 根据协议自定义的解码逻辑将其解码成Java对象
Message message = serializer.deSerialize(byteBuf);
// 解码完成后添加到List中即可
list.add(message);
}
}
复制代码
2.3 注意要点
ByteBuf默认情况下使用的是堆外内存,不进行内存释放会发生内存溢出。不过ByteToMessageDecoder
和 MessageToByteEncoder
这两个解码和编码Handler
会自动帮我们完成内存释放的操作,无需再次手动释放。因为我们实现的 encode()
和 decode()
方法只是这两个 Handler
源码中执行的一个环节,最终会在 finally 代码块中完成对内存的释放,具体内容可阅读 MessageToByteEncoder
中第99行 write()
方法源码。
2.4 在服务端中添加编码解码Handler
serverBootstrap.group(boss, worker).channel(NioServerSocketChannel.class)
.childHandler(new ChannelInitializer<NioSocketChannel>() {
@Override
protected void initChannel(NioSocketChannel nioSocketChannel) throws Exception {
nioSocketChannel.pipeline()
// 接收到请求时进行解码
.addLast(new TcpDecoder(serializer))
// 发送请求时进行编码
.addLast(new TcpEncoder(serializer));
}
});
复制代码
3. 添加业务处理Handler
在Netty框架中,客户端与服务端的每个连接都对应着一个 Channel
,而这个 Channel
的所有处理逻辑都封装在一个叫作 ChannelPipeline
的对象里。ChannelPipeline
是一个双向链表,它使用的是责任链模式,每个链表节点都是一个 Handler
,能通它能获取 Channel
相关的上下文信息(ChannelHandlerContext)。Netty为我们提供了多种读取 Channel
中数据的 Handler
,其中比较常用的是 ChannelInboundHandlerAdapter
和 SimpleChannelInboundHandler
,下文中我们以读取心跳消息为例。
3.1 ChannelInboundHandlerAdapter
如下为处理心跳业务逻辑的 Handler
,具体执行逻辑参考代码和注释即可
public class HeartBeatHandler extends ChannelInboundHandlerAdapter {
/**
* channel中有数据可读时,会回调该方法
*
* @param msg 如果在该Handler前没有解码Handler节点处理,该对象类型为ByteBuf;否则为解码后的Java对象
*/
@Override
public void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception {
Message message = (Message) msg;
// 处理心跳消息
processHeartBeatMessage(message);
// 初始化Ack消息
Message ackMessage = initialAckMessage();
// 回写给客户端
ctx.channel().writeAndFlush(ackMessage);
}
}
复制代码
3.2 SimpleChannelInboundHandler
SimpleChannelInboundHandler
是 ChannelInboundHandlerAdapter
的实现类,SimpleChannelInboundHandler
能够指定泛型,这样在处理业务逻辑时,便无需再添加上文代码中对象强转的逻辑,这部分代码实现是在 SimpleChannelInboundHandler
的 channelRead()
方法中完成的,它是一个模版方法,我们仅仅需要实现 channelRead0()
方法即可,代码示例如下
public class HeartBeatHandler extends SimpleChannelInboundHandler<Message> {
/**
* @param msg 注意这里的对象类型即为 Message
*/
@Override
protected void channelRead0(ChannelHandlerContext ctx, Message msg) throws Exception {
// 处理心跳消息
processHeartBeatMessage(message);
// 初始化Ack消息
Message ackMessage = initialAckMessage();
// 回写给客户端
ctx.channel().writeAndFlush(ackMessage);
}
}
复制代码
3.3 在服务端中添加心跳处理Handler
serverBootstrap.group(boss, worker).channel(NioServerSocketChannel.class)
.childHandler(new ChannelInitializer<NioSocketChannel>() {
@Override
protected void initChannel(NioSocketChannel nioSocketChannel) throws Exception {
nioSocketChannel.pipeline()
// 接收到进行解码
.addLast(new TcpDecoder(serializer))
// 心跳业务处理Handler
.addLast(new HeartBeatHandler())
// 发送请求时进行编码
.addLast(new TcpEncoder(serializer));
}
});
复制代码
4. ChannelHandler的生命周期
在 ChannelInboundHandlerAdapter
可以通过实现不同的方法来完成指定时机的方法回调,具体可参考如下代码
public class LifeCycleHandler extends ChannelInboundHandlerAdapter {
/**
* 当检测到新连接之后,调用 ch.pipeline().addLast(...); 之后的回调
* 表示当前channel中成功添加了 Handler
*/
@Override
public void handlerAdded(ChannelHandlerContext ctx) throws Exception {
System.out.println("逻辑处理器被添加时回调:handlerAdded()");
super.handlerAdded(ctx);
}
/**
* 表示当前channel的所有逻辑处理已经和某个NIO线程建立了绑定关系
* 这里的NIO线程通常指的是 NioEventLoop
*/
@Override
public void channelRegistered(ChannelHandlerContext ctx) throws Exception {
System.out.println("channel 绑定到线程(NioEventLoop)时回调:channelRegistered()");
super.channelRegistered(ctx);
}
/**
* 当Channel的所有业务逻辑链准备完毕,连接被激活时
*/
@Override
public void channelActive(ChannelHandlerContext ctx) throws Exception {
System.out.println("channel 准备就绪时回调:channelActive()");
super.channelActive(ctx);
}
/**
* 客户端向服务端发送数据,表示有数据可读时,就会回调该方法
*/
@Override
public void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception {
System.out.println("channel 有数据可读时回调:channelRead()");
super.channelRead(ctx, msg);
}
/**
* 服务端每完整的读完一次数据,都会回调该方法
*/
@Override
public void channelReadComplete(ChannelHandlerContext ctx) throws Exception {
System.out.println("channel 某次数据读完时回调:channelReadComplete()");
super.channelReadComplete(ctx);
}
// ---断开连接时---
/**
* 该客户端与服务端的连接被关闭时回调
*/
@Override
public void channelInactive(ChannelHandlerContext ctx) throws Exception {
System.out.println("channel 被关闭时回调:channelInactive()");
super.channelInactive(ctx);
}
/**
* 对应的NIO线程移除了对这个连接的处理
*/
@Override
public void channelUnregistered(ChannelHandlerContext ctx) throws Exception {
System.out.println("channel 取消线程(NioEventLoop) 的绑定时回调: channelUnregistered()");
super.channelUnregistered(ctx);
}
/**
* 为该连接添加的所有业务逻辑Handler被移除时
*/
@Override
public void handlerRemoved(ChannelHandlerContext ctx) throws Exception {
System.out.println("逻辑处理器被移除时回调:handlerRemoved()");
super.handlerRemoved(ctx);
}
}
复制代码
5. 解决粘包和半包问题
即使我们发送消息的时候是以 ByteBuf
的形式发送的,但是到了底层操作系统,仍然是以字节流的形式对数据进行发送的,而且服务端也以字节流的形式读取,因此在服务端对字节流进行拼接时,可能就会造成发送时 ByteBuf
与读取时的 ByteBuf
不对等的情况,这就是所谓的粘包或半包现象。
以如下情况为例,当客户端频繁的向服务端发送心跳消息时,读取到的ByteBuf信息如下,其中一个心跳请求是用红框圈出的部分
可以发现多个心跳请求"粘"在了一起,那么我们需要对它进行拆包处理,否则只会读取第一条心跳请求,之后的请求会全部失效
Netty 为我们提供了基于长度的拆包器 LengthFieldBasedFrameDecoder
来进行拆包工作,它能对超过所需数据量的包进行拆分,也能在数据不足的时候等待读取,直到数据足够时,构成一个完整的数据包并进行业务处理。
5.1 LengthFieldBasedFrameDecoder
以标准接口文档中的协议(图示)为准,代码示例如下,其中的四个参数比较重要,详细信息可见注释描述
public class SplitHandler extends LengthFieldBasedFrameDecoder {
/**
* 在协议中表示数据长度的字段在字节流首尾中的偏移量
*/
private static final Integer LENGTH_FIELD_OFFSET = 10;
/**
* 表示数据长度的字节长度
*/
private static final Integer LENGTH_FIELD_LENGTH = 4;
/**
* 数据长度后边的头信息中的字节偏移量
*/
private static final Integer LENGTH_ADJUSTMENT = 10;
/**
* 表示从第一个字节开始需要舍去的字节数,在我们的协议中,不需要进行舍去
*/
private static final Integer INITIAL_BYTES_TO_STRIP = 0;
public SplitHandler() {
super(Integer.MAX_VALUE, LENGTH_FIELD_OFFSET, LENGTH_FIELD_LENGTH, LENGTH_ADJUSTMENT, INITIAL_BYTES_TO_STRIP);
}
}
复制代码
之后将其添加到Handler中即可,如果遇到其他协议,更改其中参数或查看LengthFieldBasedFrameDecoder
的JavaDoc中详细描述。
5.2 在服务端中添加拆包Handler
serverBootstrap.group(boss, worker).channel(NioServerSocketChannel.class)
.childHandler(new ChannelInitializer<NioSocketChannel>() {
@Override
protected void initChannel(NioSocketChannel nioSocketChannel) throws Exception {
nioSocketChannel.pipeline()
// 拆包Handler
.addLast(new SplitHandler())
// 接收到进行解码
.addLast(new TcpDecoder(serializer))
// 心跳业务处理Handler
.addLast(new HeartBeatHandler())
// 发送请求时进行编码
.addLast(new TcpEncoder(serializer));
}
});
复制代码
6. Netty性能优化
6.1 Handler对单例模式的应用
Netty 在每次有新连接到来的时候,都会调用 ChannelInitializer
的 initChannel()
方法,会将其中相关的 Handler
都创建一次,如果其中的 Handler
是无状态且能够通用的,可以将其改成单例,这样就能够在每次连接建立时,避免多次创建相同的对象。
以如下服务端代码为例,包含如下Handler,可以将编码解码、以及业务处理Handler都定义成Spring单例bean的形式注入进来,这样就能够完成对象的复用而无需每次建立连接都创建相同的对象了
ServerBootstrap b = new ServerBootstrap();
b.group(bossGroup, workerGroup)
.channel(NioServerSocketChannel.class)
.childHandler(new ChannelInitializer<SocketChannel>() {
@Override
public void initChannel(SocketChannel ch) throws Exception {
ch.pipeline()
// 拆包Handler
.addLast(new SplitHandler())
// 日志Handler
.addLast(new LoggingHandler(LogLevel.INFO))
// 解码Handler
.addLast(new TcpDecoder(serializer))
// 心跳、格口状态、设备状态、RFID上报、扫码上报和分拣结果上报Handler
.addLast(new HeartBeatHandler(), new ChuteStatusHandler())
.addLast(new DeviceStatusReceiveHandler(), new RfidBindReceiveHandler())
.addLast(new ScanReceiveHandler(), new SortResultHandler())
// 编码Handler
.addLast(new TcpEncoder(serializer));
}
});
复制代码
改造完成后如下
ServerBootstrap b = new ServerBootstrap();
b.group(bossGroup, workerGroup)
.channel(NioServerSocketChannel.class)
.childHandler(new ChannelInitializer<SocketChannel>() {
@Override
public void initChannel(SocketChannel ch) throws Exception {
ch.pipeline()
// 拆包Handler
.addLast(new SplitHandler())
// 日志Handler
.addLast(new LoggingHandler(LogLevel.INFO))
// 解码Handler
.addLast(tcpDecoder)
// 心跳、格口状态、设备状态、RFID上报、扫码上报和分拣结果上报Handler
.addLast(heartBeatHandler, chuteStatusHandler)
.addLast(deviceStatusReceiveHandler, rfidBindReceiveHandler)
.addLast(scanReceiveHandler, sortResultHandler)
// 编码Handler
.addLast(tcpEncoder);
}
});
复制代码
不过需要注意在每个单例Handler的类上标注 @ChannelHandler.Sharable
注解,否则会抛出如下异常
io.netty.channel.ChannelPipelineException: netty.book.practice.handler.server.LoginHandler is not a @Sharable handler, so can't be added or removed multiple times
另外,SplitHanlder
不能进行单例处理,因为它的内部实现与每个 Channel
都有关,每个 SplitHandler
都需要维持每个 Channel
读到的数据,即它是有状态的。
6.2 缩短责任链调用
对服务端来说,每次解码出来的Java对象在多个业务处理 Handler
中只会经过一个其中 Handler
完成业务处理,那么我们将所有业务相关的 Handler
封装起来到一个Map中,每次只让它经过必要的Handler而不是经过整个责任链,那么便可以提高Netty处理请求的性能。
定义如下 ServerHandlers
单例bean,并使用 策略模式 将对应的 Handler
管理起来,每次处理时根据消息类型获取对应的 Handler
来完成业务逻辑
@ChannelHandler.Sharable
public class ServerHandlers extends SimpleChannelInboundHandler<Message> {
@Resourse
private HeartBeatHandler heartBeatHandler;
/**
* 策略模式封装Handler,这样就能在回调 ServerHandler 的 channelRead0 方法时
* 找到具体的Handler,而不需要经过责任链的每个 Handler 节点,以此来提高性能
*/
private final Map<Command, SimpleChannelInboundHandler<Message>> map;
public ServerHandler() {
map = new HashMap<>();
// key: 消息类型枚举 value: 对应的Handler
map.put(MessageType.HEART_BEAT, heartBeatHandler);
// ...
}
@Override
protected void channelRead0(ChannelHandlerContext ctx, Message msg) throws Exception {
// 调用 channelRead() 方法完成业务逻辑处理
map.get(msg.getMessageType()).channelRead(ctx, msg);
}
}
复制代码
改造完成后,服务端代码如下,因为我们封装了平行的业务处理 Handler
,所以代码很清爽
ServerBootstrap b = new ServerBootstrap();
b.group(bossGroup, workerGroup)
.channel(NioServerSocketChannel.class)
.childHandler(new ChannelInitializer<SocketChannel>() {
@Override
public void initChannel(SocketChannel ch) throws Exception {
ch.pipeline()
// 拆包Handler
.addLast(new SplitHandler())
// 日志Handler
.addLast(new LoggingHandler(LogLevel.INFO))
// 解码Handler
.addLast(tcpDecoder)
// serverHandlers 封装了 心跳、格口状态、设备状态、RFID上报、扫码上报和分拣结果上报Handler
.addLast(serverHandlers)
// 编码Handler
.addLast(tcpEncoder);
}
});
复制代码
6.3 合并编码、解码Handler
Netty 对编码解码提供了统一处理Handler是MessageToMessageCodec
,这样我们就能将编码和解码的Handler合并成一个添加接口,代码示例如下
@ChannelHandler.Sharable
public class MessageCodecHandler extends MessageToMessageCodec<ByteBuf, Message> {
/**
* 序列化器
*/
@Resourse
private Serializer serializer;
@Override
protected void encode(ChannelHandlerContext ctx, Message msg, List<Object> out) throws Exception {
// 将字节数组写入 ByteBuf
ByteBuf byteBuf = ctx.alloc().ioBuffer();
serializer.serialize(byteBuf, msg);
// 这个编码也需要添加到List中
out.add(byteBuf);
}
@Override
protected void decode(ChannelHandlerContext ctx, ByteBuf msg, List<Object> out) {
// 根据协议自定义的解码逻辑将其解码成Java对象,并添加到List中
out.add(serializer.deSerialize(msg));
}
}
复制代码
改造完成后,服务端代码如下,将其放在业务处理Handler前即可,调用完业务Handler逻辑,会执行编码逻辑
ServerBootstrap b = new ServerBootstrap();
b.group(bossGroup, workerGroup)
.channel(NioServerSocketChannel.class)
.childHandler(new ChannelInitializer<SocketChannel>() {
@Override
public void initChannel(SocketChannel ch) throws Exception {
ch.pipeline()
// 拆包Handler
.addLast(new SplitHandler())
// 日志Handler
.addLast(new LoggingHandler(LogLevel.INFO))
// 解码、编码Handler
.addLast(messageCodecHandler)
// serverHandlers 封装了 心跳、格口状态、设备状态、RFID上报、扫码上报和分拣结果上报Handler
.addLast(serverHandlers);
}
});
复制代码
6.4 减少NIO线程阻塞
对于耗时的业务操作,需要将它们都丢到业务线程池中去处理,因为单个NIO线程会管理很多 Channel
,只要有一个 Channel
中的 Handler
的 channelRead()
方法被业务逻辑阻塞,那么它就会拖慢绑定在该NIO线程上的其他所有 Channel
。
为了避免上述情况,可以在包含长时间业务处理逻辑的Handler中创建一个线程池,并将其丢入线程池中进行执行,伪代码如下
protected void channelRead(ChannelHandlerContext ctx, Object message) {
threadPool.submit(new Runnable() {
// 耗时的业务处理逻辑
doSomethingSependTooMuchTime();
writeAndFlush();
});
}
复制代码
6.5 空闲"假死"检测Handler
如果底层的TCP连接已经断开,但是另一端服务并没有捕获到,在某一端(客户端或服务端)看来会认为这条连接仍然存在,这就是连接"假死"现象。这造成的问题就是,对于服务端来说,每个连接连接都会耗费CPU和内存资源,过多的假死连接会造成性能下降和服务崩溃;对客户端来说,连接假死会使得发往服务端的请求都会超时,所以需要尽可能避免假死现象的发生。
造成假死的原因可能是公网丢包、客户端或服务端网络故障等,Netty为我们提供了IdleStateHandler
来解决超时假死问题,示例代码如下
public class MyIdleStateHandler extends IdleStateHandler {
private static final int READER_IDLE_TIME = 15;
public MyIdleStateHandler() {
// 读超时时间、写超时时间、读写超时时间 指定0值不判断超时
super(READER_IDLE_TIME, 0, 0, TimeUnit.SECONDS);
}
@Override
protected void channelIdle(ChannelHandlerContext ctx, IdleStateEvent evt) {
System.out.println(READER_IDLE_TIME + "秒内没有读到数据,关闭连接");
ctx.channel().close();
}
}
复制代码
其构造方法中有三个参数来分别指定读、写和读写超时时间,当指定0时不判断超时,除此之外Netty也有专门用来处理读和写超时的Handler,分别为 ReadTimeoutHandler
, WriteTimeoutHandler
。
将其添加到服务端 Handler
的首位即可
ServerBootstrap b = new ServerBootstrap();
b.group(bossGroup, workerGroup)
.channel(NioServerSocketChannel.class)
.childHandler(new ChannelInitializer<SocketChannel>() {
@Override
public void initChannel(SocketChannel ch) throws Exception {
ch.pipeline()
// 超时判断Handler
.addLast(new MyIdleStateHandler())
// 拆包Handler
.addLast(new SplitHandler())
// 日志Handler
.addLast(new LoggingHandler(LogLevel.INFO))
// 解码、编码Handler
.addLast(messageCodecHandler)
// serverHandlers 封装了 心跳、格口状态、设备状态、RFID上报、扫码上报和分拣结果上报Handler
.addLast(serverHandlers);
}
});