Netty学习篇--02
Channel、ChannelPipeline、ChannelHandlerContent发送数据的不同
// channel往回写数据 Channel channel = ctx.channel(); channel.writeAndFlush(Unpooled.copiedBuffer(new String("123").toCharArray(), CharsetUtil.UTF_8));
// pipeline写回数据 ChannelPipeline pipeline = ctx.pipeline(); pipeline.writeAndFlush(Unpooled.copiedBuffer(new String("123").toCharArray(), CharsetUtil.UTF_8));
// ctx写回数据 ctx.writeAndFlush(Unpooled.copiedBuffer(new String("123").toCharArray(), CharsetUtil.UTF_8));
三种方式的区别
- 前2种影响channel整个通道的channelHandler的事件
- ctx.writeAndFlush只影响当前handler
netty入站出站handler执行顺序问题
总结: 1. InboundHandler顺序执行,OutboundHandler逆序执行 2. InboundHandler通过write方法与OutboundHandler进行交互 3. InboundHandler想要传递消息到OutboundHandler,OutboundHandler需要在InboundHandler之前添加到管道中,否则在InboundHandler中write(msg)的时候OutboundHandler可能还没注册到管道中(前提是用ChannelHandlerContent进行回写数据) 4. InboundHandler和OutBoundHandler角色的不同顺序不同;针对客户端而言,客户端是先发起请求在接收数据,所以是OutboundHandler > InboundHandler;针对服务端则反之
netty异步操作
netty中所有的IO操作都是异步的,意味着任何IO调用都会立即返回,通过ChannelFuture获得IO操作的结果和状态
ChannelFuture
ChannelFuture提供了IO操作的结果和状态 它继承了io.netty.util.concurrent包下的Future 间接继承了并发包下的Future
ChannelFuture的类图
注意: 不要在IO线程内调用future对象的sync/await方法,不能再ChannelHandler中调用sync/await方法,可能导致死锁问题
ChannelPromise
继承ChannelFuture,进一步拓展用于设置IO操作结果
TCP粘包拆包
TCP拆包
所谓拆包就是一个数据包拆分成多个包进行发送,就好比咱们在同一家店购买东西过多会拆成多个包裹进去发货类似,一个完成的数据包可能会被TCP拆分成多个包进行传输发送
TCP粘包
粘包则和拆包相反,将多个小包封装成一个大的数据包,就好比快递站收到包裹不会立马运输派送,会等到一定的量才会运输派送;客户端发送若干的数据包,服务端接收的时候粘合成一个包接收
// 客户端 public class HtNettyClient { private String ip; private int port; HtNettyClient(String ip, int port) { this.ip = ip; this.port = port; } public void start() { EventLoopGroup workGroup = new NioEventLoopGroup(); try { Bootstrap bootstrap = new Bootstrap(); bootstrap.group(workGroup) .channel(NioSocketChannel.class) .remoteAddress(new InetSocketAddress(ip, port)) .handler(new ChannelInitializer<SocketChannel>() { @Override protected void initChannel(SocketChannel ch) throws Exception { ch.pipeline().addLast(new HtNettyClientHandler()); } }); ChannelFuture future = bootstrap.connect().sync(); future.channel().closeFuture().sync(); } catch (Exception e) { } finally { workGroup.shutdownGracefully(); } } public static void main(String[] args) { HtNettyClient client = new HtNettyClient("127.0.0.1", 9000); client.start(); } } // 客户端发送数据handler public class HtNettyClientHandler extends ChannelInboundHandlerAdapter { @Override public void channelActive(ChannelHandlerContext ctx) throws Exception { // 数据缓冲区 ByteBuf byteBuf = null; byte[] req = ("hetangyuese" +System.getProperty("line.separator")).getBytes(); for (int i= 0; i<10; i++) { byteBuf = Unpooled.buffer(req.length); byteBuf.writeBytes(req); ctx.writeAndFlush(byteBuf); } } // 服务端 public class HtNettyServer { private int port; HtNettyServer(int port) { this.port = port; } public void start() { // 定义一个boss来处理请求 EventLoopGroup bossGroup = new NioEventLoopGroup(1); EventLoopGroup workGroup = new NioEventLoopGroup(); try { ServerBootstrap serverBootstrap = new ServerBootstrap(); serverBootstrap.group(bossGroup, workGroup) .option(ChannelOption.SO_BACKLOG, 1024) .channel(NioServerSocketChannel.class) .childHandler(new ChannelInitializer<SocketChannel>() { @Override protected void initChannel(SocketChannel ch) throws Exception { ch.pipeline() // .addLast(new LineBasedFrameDecoder(3)) .addLast(new HtNettyHandler()); } }); // 绑定端口 ChannelFuture channelFuture = serverBootstrap.bind(port).sync(); // 阻塞至直至关闭通道 channelFuture.channel().closeFuture().sync(); } catch (Exception e) { e.printStackTrace(); } finally { bossGroup.shutdownGracefully(); workGroup.shutdownGracefully(); } } public static void main(String[] args) { HtNettyServer server = new HtNettyServer(9000); server.start(); } } // 服务端handler public class HtNettyHandler extends ChannelInboundHandlerAdapter { private int count; @Override public void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception { // 如果没有定义解码器的话 默认转byteBuf ByteBuf byteBuf = (ByteBuf)msg; byte[] params = new byte[byteBuf.readableBytes()]; byteBuf.readBytes(params); String body = new String(params, CharsetUtil.UTF_8); System.out.println("收到了请求,请求内容:" + body + ", 收到请求次数:" + ++count); } @Override public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception { cause.printStackTrace(); ctx.close(); } } // 结果 收到了请求,请求内容:hetangyuese hetangyuese hetangyuese hetangyuese hetangyuese hetangyuese hetangyuese hetangyuese hetangyuese hetangyuese , 收到请求次数:1
粘、拆包
为何TCP会导致粘包和拆包? TCP每次在发送数据时都是以流的形式进行传输,底层有一个缓冲区来存储发送的字节流, 1.当发送数据小于缓冲区的饱和的大小时,会发生粘包,粘成一个包发送至服务端(每个包之间的间隔时间短,包数据很小); 2.当发送的数据大于缓冲区的阈值,则会拆分成多个包进行发送 3.服务端没及时读取缓冲区的数据,导致数据堆积,可能导致服务端粘包 4.发送方由于Nagle算法机制
Nagle算法
TCP/IP协议中,无论发送多少数据,总是要在数据前面加上协议头,同时,对方接收到数据,也需要发送ACK表示确认。为了尽可能的利用网络带宽,TCP总是希望尽可能的发送足够大的数据。(一个连接会设置MSS参数,因此,TCP/IP希望每次都能够以MSS尺寸的数据块来发送数据)。Nagle算法就是为了尽可能发送大块数据,避免网络中充斥着许多小数据块。
粘包、拆包解决方法
1. 设置定长消息(根据业务设置足够长) 2. 设置消息的边界(设置分隔符) 3. 使用带消息头的协议,消息头存储消息开始标识及消息的长度信息 4. 发送端关闭Nagle算法
Netty编、解码器
Decoder解码
主要对应的是ChannelInboundHandler,主要作用将字节数组转换成对象消息
Decoder解码常用抽象类
ByteToMessageDecoder
字节码转消息对象时需要检查缓冲区是否有足够的字节
@Override protected void decode(ChannelHandlerContext ctx, ByteBuf in,List<Object> out) throws Exception { // 假使消息为int字节 则需要判断bytebuf字节是否大于等于4 if (in.readableBytes() >= 4) { // 符合的话就add到list对象中(解析对象) out.add(in.readInt()); } }
ReplayingDecoder
继承了ByteToMessageDecoder,不需要检查缓冲区是否有足够多的数据,速度略慢于ByteToMessageDecoder; tips: 根据项目的复杂程度合理选择,常用ByteToMessageDecoder
MessageToMessageDecoder
用于从一种消息解码到另外一种消息
解码器的具体实现 (主要解决TCP底层的粘包和拆包问题)
DelimiterBasedFrameDecoder
指定消息分隔符的解码器(客户端发送数据所有的数据末尾都需要增加分隔符,否则服务端接收不到)
// 定义最大长度及需要的切割符 public DelimiterBasedFrameDecoder(int maxFrameLength, ByteBuf delimiter) { this(maxFrameLength, true, delimiter); } // 定义切割符 ByteBuf delimiter = Unpooled.copiedBuffer("自定义分隔符".getBytes()); /** * maxFrameLength:解析分隔符最大长度 * stripDelimiter:true表示解析数据隐藏分隔符,反之解析数据末尾都会带上分隔符 * failFast: true表示超出maxLength立刻抛出异常,false则会解析完在抛出异常 * delimiter: 分隔符 */ public DelimiterBasedFrameDecoder( int maxFrameLength, boolean stripDelimiter, boolean failFast, ByteBuf delimiter) { this(maxFrameLength, stripDelimiter, failFast, new ByteBuf[] { delimiter.slice(delimiter.readerIndex(), delimiter.readableBytes())}); } // 客户端请求体 reqStr = "hello!_" + "My name is hanleilei !_" + "What is your name !_" + "How are you? !_" ; // 服务端增加解析 以!_为分隔符 .addLast(new DelimiterBasedFrameDecoder(1024,Unpooled.copiedBuffer("!_".getBytes()))) // 结果 收到了请求,请求内容:hello, 收到请求次数:1 收到了请求,请求内容:My name is hanleilei , 收到请求次数:2 收到了请求,请求内容:What is your name , 收到请求次数:3 收到了请求,请求内容:How are you? , 收到请求次数:4 // 服务端设置stripDelimiter为false addLast(new DelimiterBasedFrameDecoder(1024, false, Unpooled.copiedBuffer("!_".getBytes()))); //结果 收到了请求,请求内容:hello!_, 收到请求次数:1 收到了请求,请求内容:My name is hanleilei !_, 收到请求次数:2 收到了请求,请求内容:What is your name !_, 收到请求次数:3 收到了请求,请求内容:How are you? !_, 收到请求次数:4
LineBasedFrameDecoder
以换行符为结束标志的解码器 // 如果发送的数据超过了maxLength还未解析到换行符则抛出TooLongFrameException异常 public LineBasedFrameDecoder(final int maxLength) { this(maxLength, true, false); }
// 服务端定义最大长度为3的换行解码器 public void start() { // 定义一个boss来处理请求 EventLoopGroup bossGroup = new NioEventLoopGroup(1); EventLoopGroup workGroup = new NioEventLoopGroup(); try { ServerBootstrap serverBootstrap = new ServerBootstrap(); serverBootstrap.group(bossGroup, workGroup) .option(ChannelOption.SO_BACKLOG, 1024) .channel(NioServerSocketChannel.class) .childHandler(new ChannelInitializer<SocketChannel>() { @Override protected void initChannel(SocketChannel ch) throws Exception { ch.pipeline() .addLast(new LineBasedFrameDecoder(3)) .addLast(new HtNettyHandler()); } }); // 绑定端口 ChannelFuture channelFuture = serverBootstrap.bind(port).sync(); // 阻塞至直至关闭通道 channelFuture.channel().closeFuture().sync(); } catch (Exception e) { e.printStackTrace(); } finally { bossGroup.shutdownGracefully(); workGroup.shutdownGracefully(); } } // 客户端发送 public class HtNettyClientHandler extends ChannelInboundHandlerAdapter { @Override public void channelActive(ChannelHandlerContext ctx) throws Exception { // 客户端注册是发送数据至服务端 ByteBuf byteBuf = null; byte[] req = ("hetangyuese" +System.getProperty("line.separator")).getBytes(); for (int i= 0; i<10; i++) { byteBuf = Unpooled.buffer(req.length); byteBuf.writeBytes(req); ctx.writeAndFlush(byteBuf); } } } // 异常 io.netty.handler.codec.TooLongFrameException: frame length (11) exceeds the allowed maximum (3) at io.netty.handler.codec.LineBasedFrameDecoder.fail(LineBasedFrameDecoder.java:146) at io.netty.handler.codec.LineBasedFrameDecoder.fail(LineBasedFrameDecoder.java:142) at io.netty.handler.codec.LineBasedFrameDecoder.decode(LineBasedFrameDecoder.java:99) at io.netty.handler.codec.LineBasedFrameDecoder.decode(LineBasedFrameDecoder.java:75) at io.netty.handler.codec.ByteToMessageDecoder.decodeRemovalReentryProtection(ByteToMessageDecoder.java:489) at io.netty.handler.codec.ByteToMessageDecoder.callDecode(ByteToMessageDecoder.java:428) at io.netty.handler.codec.ByteToMessageDecoder.channelRead(ByteToMessageDecoder.java:265) at io.netty.channel.AbstractChannelHandlerContext.invokeChannelRead(AbstractChannelHandlerContext.java:362) at io.netty.channel.AbstractChannelHandlerContext.invokeChannelRead(AbstractChannelHandlerContext.java:348) at io.netty.channel.AbstractChannelHandlerContext.fireChannelRead(AbstractChannelHandlerContext.java:340) at io.netty.channel.DefaultChannelPipeline$HeadContext.channelRead(DefaultChannelPipeline.java:1359) at io.netty.channel.AbstractChannelHandlerContext.invokeChannelRead(AbstractChannelHandlerContext.java:362) at io.netty.channel.AbstractChannelHandlerContext.invokeChannelRead(AbstractChannelHandlerContext.java:348) at io.netty.channel.DefaultChannelPipeline.fireChannelRead(DefaultChannelPipeline.java:935) at io.netty.channel.nio.AbstractNioByteChannel$NioByteUnsafe.read(AbstractNioByteChannel.java:134) at io.netty.channel.nio.NioEventLoop.processSelectedKey(NioEventLoop.java:645) at io.netty.channel.nio.NioEventLoop.processSelectedKeysOptimized(NioEventLoop.java:580) at io.netty.channel.nio.NioEventLoop.processSelectedKeys(NioEventLoop.java:497) at io.netty.channel.nio.NioEventLoop.run(NioEventLoop.java:459) at io.netty.util.concurrent.SingleThreadEventExecutor$5.run(SingleThreadEventExecutor.java:858) at io.netty.util.concurrent.DefaultThreadFactory$DefaultRunnableDecorator.run(DefaultThreadFactory.java:138) at java.lang.Thread.run(Thread.java:748) // 修改长度 addLast(new LineBasedFrameDecoder(1024)) // 结果 收到了请求,请求内容:hetangyuese, 收到请求次数:1 收到了请求,请求内容:hetangyuese, 收到请求次数:2 收到了请求,请求内容:hetangyuese, 收到请求次数:3 收到了请求,请求内容:hetangyuese, 收到请求次数:4 收到了请求,请求内容:hetangyuese, 收到请求次数:5 收到了请求,请求内容:hetangyuese, 收到请求次数:6 收到了请求,请求内容:hetangyuese, 收到请求次数:7 收到了请求,请求内容:hetangyuese, 收到请求次数:8 收到了请求,请求内容:hetangyuese, 收到请求次数:9 收到了请求,请求内容:hetangyuese, 收到请求次数:10
FixedLengthFrameDecoder
固定长度的解码器
/** * frameLength:解析的消息体长度,每次直解析frameLength长度字节消息 */ public FixedLengthFrameDecoder(int frameLength) { if (frameLength <= 0) { throw new IllegalArgumentException( "frameLength must be a positive integer: " + frameLength); } this.frameLength = frameLength; } // 客户端 package com.hetangyuese.netty.client.handler; import io.netty.buffer.ByteBuf; import io.netty.buffer.Unpooled; import io.netty.channel.ChannelHandlerContext; import io.netty.channel.ChannelInboundHandlerAdapter; /** * @program: netty-root * @description: 客户端逻辑类 * @author: hewen * @create: 2019-10-22 17:15 **/ public class HtNettyClientHandler extends ChannelInboundHandlerAdapter { @Override public void channelActive(ChannelHandlerContext ctx) throws Exception { String reqStr = ""; // 数据缓冲区 ByteBuf byteBuf = null; // reqStr = "hetangyuese" + System.getProperty("line.separator"); reqStr = "hello!_" + "My name is hanleilei !_" + "What is your name !_" + "How are you? !_" ; byte[] req = (reqStr).getBytes(); // for (int i= 0; i<10; i++) { byteBuf = Unpooled.buffer(req.length); byteBuf.writeBytes(req); ctx.writeAndFlush(byteBuf); // } } } // 服务端解析(直接解析3个字节) ch.pipeline().addLast(new FixedLengthFrameDecoder(3)) .addLast(new HtNettyHandler()); // 结果 收到了请求,请求内容:hel, 收到请求次数:1 收到了请求,请求内容:lo!, 收到请求次数:2 收到了请求,请求内容:_My, 收到请求次数:3 收到了请求,请求内容: na, 收到请求次数:4 收到了请求,请求内容:me , 收到请求次数:5 收到了请求,请求内容:is , 收到请求次数:6 收到了请求,请求内容:han, 收到请求次数:7 收到了请求,请求内容:lei, 收到请求次数:8 收到了请求,请求内容:lei, 收到请求次数:9 收到了请求,请求内容: !_, 收到请求次数:10 收到了请求,请求内容:Wha, 收到请求次数:11 收到了请求,请求内容:t i, 收到请求次数:12 收到了请求,请求内容:s y, 收到请求次数:13 收到了请求,请求内容:our, 收到请求次数:14 收到了请求,请求内容: na, 收到请求次数:15 收到了请求,请求内容:me , 收到请求次数:16 收到了请求,请求内容:!_H, 收到请求次数:17 收到了请求,请求内容:ow , 收到请求次数:18 收到了请求,请求内容:are, 收到请求次数:19 收到了请求,请求内容: yo, 收到请求次数:20 收到了请求,请求内容:u? , 收到请求次数:21
LengthFieldBasedFrameDecoder
消息包括 :消息头 + 消息体,基于长度通用的解码器
/** * maxFrameLength: 消息数据最大长度 * * lengthFieldOffset:长度字段偏移位,长度字段开始的地方,跳过指定长度字节之后的消 * 息才是消息体字段,一般设置为0,从头部开始 * * lengthFieldLength:消息头长度字段占的字节数,如果设为2则表示在 * lengthFieldOffset开始往后的2个字节存储消息体长度 * * lengthAdjustment:调整消息体长度字段,如果消息包括消息头(即长度字段),如果需要* 去掉消息头则需要对应设置为负数(长度字段的字节长度),netty解析要减去对应的数值获取* 消息体 * * initialBytesToStrip:是否需要剔除消息头,在获取到一个完整的数据包之后,去除长度 * 字节,直接拿到消息体的数据,为0代表不去除消息头 * * failFast:是否快速失败,true代表在数据长度超出最大长度则立刻抛出异常 */ public LengthFieldBasedFrameDecoder( int maxFrameLength, int lengthFieldOffset, int lengthFieldLength, int lengthAdjustment, int initialBytesToStrip, boolean failFast) { this( ByteOrder.BIG_ENDIAN, maxFrameLength, lengthFieldOffset, lengthFieldLength, lengthAdjustment, initialBytesToStrip, failFast); }
StringDecoder
文本解码器,将接收到的消息解码成字符串,一般与上述搭配使用,然后在后面加业务的handler
Encoder编码器
主要对应的是ChannelOutboundHandler,将消息对象转换为字节数组
Encoder解码常用的抽象解码类
MessageToByteEncoder
消息转为字节数组,write方法会判断是否支持消息类型,如果不支持则通过context传递到下一个ChannelOutboundHandler,自定义需要重写encode方法
@Override public void write(ChannelHandlerContext ctx, Object msg, ChannelPromise promise) throws Exception { ByteBuf buf = null; try { // 判断是否支持的消息类型 if (acceptOutboundMessage(msg)) { @SuppressWarnings("unchecked") I cast = (I) msg; buf = allocateBuffer(ctx, cast, preferDirect); try { encode(ctx, cast, buf); } finally { ReferenceCountUtil.release(cast); } if (buf.isReadable()) { ctx.write(buf, promise); } else { buf.release(); ctx.write(Unpooled.EMPTY_BUFFER, promise); } buf = null; } else { // 如果不支持则通过context传递到下一个ChannelOutboundHandler ctx.write(msg, promise); } } catch (EncoderException e) { throw e; } catch (Throwable e) { throw new EncoderException(e); } finally { if (buf != null) { buf.release(); } } }
MessageToMessageEncoder:将一种消息编码为另外一种消息