ChannelHandler家族
channel的生命周期
Interface Channel定义了一组和ChannelInboundHandler API密切相关的简单但功能强大的状态模型，其Channel主要有4个状态。
| 状态 |
描述 |
| ChannelUnregistered |
Channel 已经被创建，但还未注册到EventLoop |
| ChannelRegistered |
Channel 已经被注册到了EventLoop |
| ChannelActive |
Channel 处于活动状态（已经连接到它的远程节点）。它现在可以接收和发送数据了 |
| ChannelInactive |
Channel 没有连接到远程节点 |
当这些状态发生改变时，将会生成对应的事件。这些事件将会被转发给ChannelPipeline中的ChannelHandler，其可以随后对它们做出响应。
ChannelHandler的生命周期
interface ChannelHandler定义的生命周期操作如下所示，在ChannelHandler被添加到ChannelPipeline中或者被ChannelPipeline中移除时会调用 这些操作。这些方法中的每一个都接受一个ChannelHandlerContext参数。
| 状态 |
描述 |
| handlerAdded |
当把 ChannelHandler 添加到 ChannelPipeline 中时被调用 |
| handlerRemoved |
当从 ChannelPipeline 中移除 ChannelHandler 时被调用 |
| exceptionCaught |
当处理过程中在 ChannelPipeline 中有错误时被调用 |
ChannelHandler有两个重要的子接口：
- ChannelInboundHandler——处理入站数据以及各种状态变化；
- ChannelOutboundHandler——处理出站数据并且允许拦截所有的操作。
ChannelInboundHandler接口
以下方法将会在数据被接收时或者 与其对应的Channel状态发生改变时被调用
/*** {@link ChannelHandler} which adds callbacks for state changes. This allows the user* to hook in to state changes easily.*/
public interface ChannelInboundHandler extends ChannelHandler {/*** 当Channel已经注册到它的EventLoop并且能够处理I/O时被调用*/void channelRegistered(ChannelHandlerContext ctx) throws Exception;/*** 当Channel从它的EventLoop注销并且无法处理任何I/O时被调用*/void channelUnregistered(ChannelHandlerContext ctx) throws Exception;/*** 当Channel处于活动状态时被调用；Channel已经连接/绑定并且已经就绪*/void channelActive(ChannelHandlerContext ctx) throws Exception;/*** 当Channel离开活动状态并且不再连接它的远程节点时被调用*/void channelInactive(ChannelHandlerContext ctx) throws Exception;/*** 当从Channel读取数据时被调用*/void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception;/*** 当Channel上的一个读操作完成时被调用*/void channelReadComplete(ChannelHandlerContext ctx) throws Exception;/*** 当ChannelnboundHandler.fireUserEventTriggered()方法被调用时被调用，因为一个POJO被传经了ChannelPipeline*/void userEventTriggered(ChannelHandlerContext ctx, Object evt) throws Exception;/*** 当Channel的可写状态发生改变时被调用。用户可以确保写操作不会完成得太快（以避免发生OutOfMemoryError）或者可以在Channel变为再次可写时恢复写入。可以通过调用Channel的isWritable()方法来检测Channel的可写性。与可写性相关的阈值可以通过Channel.config().setWriteHighWaterMark()和Channel.config().setWriteLowWater-Mark()方法来设置*/void channelWritabilityChanged(ChannelHandlerContext ctx) throws Exception;/*** 如果抛出一个可抛出的异常对象，则调用。*/@Override@SuppressWarnings("deprecation")void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception;
}ChannelOutboundHandler接口
出站操作和数据将由ChannelOutboundHandler处理。它的方法将被Channel、ChannelPipeline以及ChannelHandlerContext调用。ChannelOutboundHandler的一个强大的功能是可以按需推迟操作或者事件，这使得可以通过一些复杂的方法来处理请求。例如，如果到远程节点的写入被暂停了，那么你可以推迟冲刷操作并在稍后继续。
public interface ChannelOutboundHandler extends ChannelHandler {/*** 当请求将Channel绑定到本地地址时被调用*/void bind(ChannelHandlerContext ctx, SocketAddress localAddress, ChannelPromise promise) throws Exception;/*** 当请求将Channel连接到远程节点时被调用*/void connect(ChannelHandlerContext ctx, SocketAddress remoteAddress,SocketAddress localAddress, ChannelPromise promise) throws Exception;/*** 当请求将Channel从远程节点断开时被调用*/void disconnect(ChannelHandlerContext ctx, ChannelPromise promise) throws Exception;/*** 当请求关闭Channel时被调用*/void close(ChannelHandlerContext ctx, ChannelPromise promise) throws Exception;/*** 当请求将Channel从它的EventLoop注销时被调用*/void deregister(ChannelHandlerContext ctx, ChannelPromise promise) throws Exception;/*** 当请求从Channel读取更多的数据时被调用*/void read(ChannelHandlerContext ctx) throws Exception;/*** 当请求通过Channel将数据写到远程节点时被调用*/void write(ChannelHandlerContext ctx, Object msg, ChannelPromise promise) throws Exception;/*** 当请求通过Channel将入队数据冲刷到远程节点时被调用*/void flush(ChannelHandlerContext ctx) throws Exception;
}ChannelPromise与ChannelFuture ChannelOutboundHandler中的大部分方法都需要一个ChannelPromise参数，以便在操作完成时得到通知。ChannelPromise是ChannelFuture的一个子类，其定义了一些可写的方法，如setSuccess()和setFailure()，从而使ChannelFuture不可变。
ChannelHandler适配器
ChannelInboundHandlerAdapter和ChannelOutboundHandlerAdapter类作为自己的ChannelHandler的适配器类。这两个适配器分别提供了ChannelInboundHandler和ChannelOutboundHandler的基本实现。通过扩展抽象类ChannelHandlerAdapter，它们获得了它们共同的超接口ChannelHandler的方法。生成的类的层次结构如：
ChannelHandlerAdapter还提供了实用方法isSharable()。如果其对应的实现被标注为Sharable，那么 这个方法将返回true，表示它可以被添加到多个ChannelPipeline中。（@Sharable注解）
在ChannelInboundHandlerAdapter和ChannelOutboundHandlerAdapter中所提供的方法体调用了其相关联的ChannelHandlerContext上的等效方法，从而将事件转发到了ChannelPipeline中的下一个ChannelHandler中。
资源管理
为了诊断潜在的（资源泄漏）问题，Netty提供了class ResourceLeakDetector它将对你应用程序的缓冲区分配做大约1%的采样来检测内存泄露。相关的开销是非常小的。
Netty目前定义了4种泄漏检测级别：
| 级别 |
描述 |
| DISABLED |
禁用泄漏检测。只有在详尽的测试之后才应使用 |
| SIMPLE |
使用1%的默认采样率检测并报告任何发现的泄露。这是默认级别，适合绝大部分情况。 |
| ADVANCED |
使用默认的采样率，报告所发现的任何的泄露以及对应的消息被访问的位置 |
| PARANOID |
类似于ADVANCED，但是其将会对每次（对消息的）访问都进行采样。这对性能将会有很大影响，在调试阶段使用 |
泄露检测级别可以通过将下面的Java系统属性设置为表中的一个值来定义：
java-Dio.netty.leakDetectionLevel=ADVANCED
如果一个消息被消费或者丢弃了，并且没有传递给ChannelPipeline中的下一个ChannelOutboundHandler，那么用户就有责任调用ReferenceCountUtil.release()。如果消息到达了实际的传输层，那么当它被写入时或者Channel关闭时，都将被自动释放。
ChannelPipeline接口
ChannelPipeline是一个拦截流经Channel的入站和出站事件的Channel-Handler实例链，那么就很容易看出这些ChannelHandler之间的交互是组成一个应用程序数据和事件处理逻辑的核心。
每一个新创建的Channel都将会被分配一个新的ChannelPipeline。这项关联是永久性的；Channel既不能附加另外一个ChannelPipeline，也不能分离其当前的。在Netty组件的生命周期中，这是一项固定的操作，不需要开发人员的任何干预。
根据事件的起源，事件将会被ChannelInboundHandler或者ChannelOutboundHandler处理。随后，通过调用ChannelHandlerContext实现，它将被转发给同一超类型的下一个ChannelHandler。
ChannelHandlerContext：
ChannelHandlerContext使得ChannelHandler能够和它的ChannelPipeline以及其他的ChannelHandler交互。ChannelHandler可以通知其所属的ChannelPipeline中的下一个ChannelHandler，甚至可以动态修改它所属的ChannelPipeline。 ChannelHandlerContext具有丰富的用于处理事件和执行I/O 操作的API。
当你完成了通过调用ChannelPipeline.add*()方法将入站处理器（ChannelInboundHandler）和出站处理器（ChannelOutboundHandler）混合添加到ChannelPipeline之后，每一个ChannelHandler从头部到尾端的顺序位置正如同我们方才所定义它们的一样。因此，如果你将图中的处理器（ChannelHandler）从左到右进行编号，那么第一个被入站事件看到的ChannelHandler将是1，而第一个被出站事件看到的ChannelHandler将是 5。
在ChannelPipeline传播事件时，它会测试ChannelPipeline中的下一个Channel-Handler的类型是否和事件的运动方向相匹配。如果不匹配，ChannelPipeline将跳过该ChannelHandler并前进到下一个，直到它找到和该事件所期望的方向相匹配的为止。
修改 ChannelPipeline
ChannelHandler可以通过添加、删除或者替换其他的ChannelHandler来实时地修改ChannelPipeline的布局。
| 名称 |
描述 |
| addFirst addBefore addAfter addLast |
将一个ChannelHandler 添加到ChannelPipeline 中 |
| remove |
将一个ChannelHandler 从 ChannelPipeline 中移除 |
| replace |
将 ChannelPipeline 中的一个 ChannelHandler 替换为另一个ChannelHandler |
ChannelHandler的执行和阻塞
通常ChannelPipeline中的每一个ChannelHandler都是通过它的EventLoop（I/O 线程）来处理传递给它的事件的。所以至关重要的是不要阻塞这个线程，因为这会对整体的I/O 处理产生负面的影响。但有时可能需要与那些使用阻塞API 的遗留代码进行交互。对于这种情况，ChannelPipeline有一些接受一个EventExecutorGroup的add()方法。如果一个事件被传递给一个自定义的EventExecutorGroup，它将被包含在这个EventExecutorGroup中的某个EventExecutor所处理，从而被从该Channel本身的EventLoop中移除。对于这种用例，Netty提供了一个叫DefaultEventExecutor-Group的默认实现。
通过类型或者名称来访问ChannelHandler的方法：
| 名称 |
描述 |
| get |
通过类型或者名称返回 ChannelHandler |
| context |
返回和ChannelHandler 绑定的 ChannelHandlerContext |
| names |
返回ChannelPipeline 中所有 ChannelHandler 的名称 |
触发事件
ChannelPipeline的API公开了用于调用入站和出站操作的附加方法：
ChannelPipeline的入站操作：
| 方法名称 | 描述 |
| fireChannelRegistered | 调用ChannelPipeline中下一个ChannelInboundHandler的channelRegistered(ChannelHandlerContext)方法 |
| fireChannelUnregistered | 调用ChannelPipeline中下一个ChannelInboundHandler的fireChannelUnregistered(ChannelHandlerContext)方法 |
| fireChannelActive | 调用ChannelPipeline中下一个ChannelInboundHandler的fireChannelActive(ChannelHandlerContext)方法 |
| fireChannelInactive | 调用ChannelPipeline中下一个ChannelInboundHandler的fireChannelInactive(ChannelHandlerContext)方法 |
| fireExceptionCaught | 调用ChannelPipeline中下一个ChannelInboundHandler的fireExceptionCaught(ChannelHandlerContext)方法 |
| fireUserEventTriggered | 调用ChannelPipeline中下一个ChannelInboundHandler的fireUserEventTriggered(ChannelHandlerContext)方法 |
| fireChannelRead | 调用ChannelPipeline中下一个ChannelInboundHandler的fireChannelRead(ChannelHandlerContext)方法 |
| fireChannelReadComplete | 调用ChannelPipeline中下一个ChannelInboundHandler的fireChannelReadComplete(ChannelHandlerContext)方法 |
| fireChannelWritabilityChanged | 调用ChannelPipeline中下一个ChannelInboundHandler的fireChannelWritabilityChanged(ChannelHandlerContext)方法 |
在出站这边，处理事件将会导致底层的套接字上发生一系列的动作。
ChannelPipeline的出站操作：
| 方法名称 | 描述 |
| bind | 将Channel绑定到一个本地地址，这将调用ChannelPipeline中的下一个ChannelOutboundHandler的bind(ChannelHandlerContext,Socket-Address, ChannelPromise)方法 |
| connect | 将Channel连接到一个远程地址，这将调用ChannelPipeline中的下一个ChannelOutboundHandler的connect(ChannelHandlerContext, SocketAddress, ChannelPromise)方法 |
| disconnect | 将Channel断开连接 。这将调用ChannelPipeline中的下一个ChannelOutboundHandler的disconnect(ChannelHandlerContext, ChannelPromise)方法 |
| close | 将Channel关闭。 这将调用ChannelPipeline中的下一个ChannelOutboundHandler的close(ChannelHandlerContext, ChannelPromise)方法 |
| deregister | 将Channel从它先前所分配的EventExecutor（即EventLoop）中注销。这将调用ChannelPipeline中的下一个ChannelOutboundHandler的deregister(ChannelHandlerContext, ChannelPromise)方法 |
| flush | 冲刷Channel所有挂起的写入。这将调用ChannelPipeline中的下一个ChannelOutboundHandler的flush(ChannelHandlerContext)方法 |
| write | 将消息写入Channel。这将调用ChannelPipeline中的下一个ChannelOutboundHandler的write(ChannelHandlerContext, Object msg, Channel-Promise)方法。注意：这并不会将消息写入底层的Socket，而只会将它放入队列中。要将它 写入Socket，需要调用flush()或者writeAndFlush()方法 |
| writeAndFlush | 这是一个先调用write()方法再接着调用flush()方法的便利方法 |
| read | 请求从Channel中读取更多的数据。这将调用ChannelPipeline中的下一个ChannelOutboundHandler的read(ChannelHandlerContext)方法 |
总结：
- ChannelPipeline保存了与Channel相关联的ChannelHandler；
- ChannelPipeline可以根据需要，通过添加或者删除ChannelHandler来动态地修改；
- ChannelPipeline有着丰富的API用以被调用，以响应入站和出站事件。
ChannelHandlerContext接口
ChannelHandlerContext代表了ChannelHandler和ChannelPipeline之间的关联，每当有ChannelHandler添加到ChannelPipeline中时，都会创建ChannelHandlerContext。ChannelHandlerContext的主要功能是管理它所关联的ChannelHandler和在同一个ChannelPipeline中的其他ChannelHandler之间的交互。
ChannelHandlerContext有很多的方法，其中一些方法也存在于Channel和ChannelPipeline本身上，但是有一点重要的不同。如果调用Channel或者ChannelPipeline上的这些方法，它们将沿着整个ChannelPipeline进行传播。而调用位于ChannelHandlerContext上的相同方法，则将从当前所关联的ChannelHandler开始，并且只会传播给位于该ChannelPipeline中的下一个能够处理该事件的ChannelHandler。
public interface ChannelHandlerContext extends AttributeMap, ChannelInboundInvoker, ChannelOutboundInvoker {/*** 返回绑定到这个实例的Channel*/Channel channel();/*** 返回调度事件的EventExecutor*/EventExecutor executor();/*** 返回这个实例的唯一名称*/String name();/*** 返回绑定到这个实例的ChannelHandler*/ChannelHandler handler();/*** 如果所关联的ChannelHandler已经被从ChannelPipeline中移除则返回true*/boolean isRemoved();/*** 触发对下一个ChannelInboundHandler上的fireChannelRegistered()方法的调用*/@OverrideChannelHandlerContext fireChannelRegistered();/*** 触发对下一个ChannelInboundHandler上的fireChannelUnregistered()方法的调用*/@OverrideChannelHandlerContext fireChannelUnregistered();/*** 触发对下一个ChannelInboundHandler上的fireChannelActive()方法的调用*/@OverrideChannelHandlerContext fireChannelActive();/*** 触发对下一个ChannelInboundHandler上的fireChannelInactive()方法的调用*/@OverrideChannelHandlerContext fireChannelInactive();/*** 触发对下一个ChannelInboundHandler上的fireExceptionCaught()方法的调用*/@OverrideChannelHandlerContext fireExceptionCaught(Throwable cause);/*** 触发对下一个ChannelInboundHandler上的fireUserEventTriggered()方法的调用*/@OverrideChannelHandlerContext fireUserEventTriggered(Object evt);/*** 触发对下一个ChannelInboundHandler上的fireChannelRead()方法的调用*/@OverrideChannelHandlerContext fireChannelRead(Object msg);/*** 触发对下一个ChannelInboundHandler上的fireChannelReadComplete()方法的调用*/@OverrideChannelHandlerContext fireChannelReadComplete();/*** 触发对下一个ChannelInboundHandler上的fireChannelWritabilityChanged()方法的调用*/@OverrideChannelHandlerContext fireChannelWritabilityChanged();/*** 将数据从Channel读取到第一个入站缓冲区；如果读取成功则触发一个channelRead事件，并（在最后一个消息被读取完成后）通知ChannelInboundHandler的channelReadComplete(ChannelHandlerContext)方法*/@OverrideChannelHandlerContext read();/*** 刷新所有挂起的消息。*/@OverrideChannelHandlerContext flush();/*** 返回这个实例所关联的ChannelPipeline*/ChannelPipeline pipeline();/*** 返回和这个实例相关联的Channel所配置的ByteBufAllocator*/ByteBufAllocator alloc();/******************补充*************************///write 通过这个实例写入消息并经过ChannelPipeline//writeAndFlush 通过这个实例写入并冲刷消息并经过ChannelPipeline}使用ChannelHandlerContext的API的时候，请牢记以下两点：
- ChannelHandlerContext和ChannelHandler之间的关联（绑定）是永远不会改变的，所以缓存对它的引用是安全的；
- 相对于其他类的同名方法，ChannelHandlerContext的方法将产生更短的事件流，应该尽可能地利用这个特性来获得最大的性能。
使用 ChannelHandlerContext
修改客户端的ChildChannelHandler：
private class ChildChannelHandler extends ChannelInitializer<SocketChannel> {protected void initChannel(SocketChannel ch) throws Exception {System.out.println("客户端启动……");ByteBuf bufs= Unpooled.copiedBuffer("pipeline发送的数据->", Charset.forName("UTF-8"));ch.pipeline().write(bufs);//通过调用ChannelPipeline的write方法将数据写入通道，但是不刷新ch.pipeline().addLast("text",new ChannelInboundHandlerAdapter() {@Overridepublic void channelActive(ChannelHandlerContext ctx) throws Exception {ctx.channel().write(Unpooled.copiedBuffer("通过ChannelHandlerContext获取的channel发送的消息->",Charset.forName("UTF-8")));//通过ChannelHandlerContext获取的channel发送的消息->CompositeByteBuf messageBuf=Unpooled.compositeBuffer();ByteBuf headerBuf=buf;ByteBuf bodyBuf=buf;messageBuf.addComponent(bodyBuf);//将ByteBuf实例追加到CompositeByteBufmessageBuf.addComponent(headerBuf);for (ByteBuf buf:messageBuf){//遍历所有ByteBufSystem.out.println(buf);byte[] req = new byte[buf.readableBytes()];buf.readBytes(req);String body = new String(req, "UTF-8");System.out.println("复合缓冲区："+body);}ctx.writeAndFlush(buf);}public void channelRead(ChannelHandlerContext ctx, Object msg)throws Exception {ByteBuf buf = (ByteBuf) msg;ByteBuf copyBuf=((ByteBuf) msg).copy();
// System.out.println(buf.refCnt());//返回此对象的引用计数。如果为0，则表示此对象已被释放。
// buf.release();//释放引用计数对象for (int i = 0; i < buf.capacity(); i++) {byte b=buf.getByte(i);if((char)b>='a'&&(char)b<='z'||(char)b>='A'&&(char)b<='Z'||(char)b==',')System.out.println("i="+(char)b);}int i=buf.forEachByte(new ByteProcessor() {@Overridepublic boolean process(byte value) throws Exception {byte[] b=",".getBytes();if (b[0]!=value)return true;elsereturn false;}});System.out.println("i="+i+" value="+(char) buf.getByte(i));ByteBuf sliced = buf.slice(0,2);sliced.setByte(0,(byte)'h');byte[] req = new byte[buf.readableBytes()];buf.readBytes(req);String body = new String(req, "UTF-8");System.out.println(body);ctx.fireChannelRead(copyBuf);}});ch.pipeline().addLast("text2",new ChannelInboundHandlerAdapter(){public void channelRead(ChannelHandlerContext ctx, Object msg)throws Exception {ByteBuf buf = (ByteBuf) msg;byte[] req = new byte[buf.readableBytes()];buf.readBytes(req);String body = new String(req, "UTF-8");System.out.println("text2:"+body);ByteBuf bufs= Unpooled.copiedBuffer("test2发送的数据", Charset.forName("UTF-8"));ctx.writeAndFlush(bufs);ctx.close();}});
// ch.pipeline().remove("text2");}}
被调用的Channel或ChannelPipeline上的write()方法将一直传播事件通过整个ChannelPipeline，但是在ChannelHandler的级别上，事件从一个ChannelHandler到下一个ChannelHandler的移动是由ChannelHandlerContext上的调用完成的。
要想调用从某个特定的ChannelHandler开始的处理过程，必须获取到在（ChannelPipeline）该ChannelHandler之前的ChannelHandler所关联的ChannelHandlerContext。这个ChannelHandlerContext将调用和它所关联的ChannelHandler之后的ChannelHandler。
消息将从下一个ChannelHandler开始流经ChannelPipeline，绕过了所有前面的ChannelHandler。
因为一个ChannelHandler可以从 属于多个ChannelPipeline，所以它也可以绑定到多个ChannelHandlerContext实例。 对于这种用法 指在多个ChannelPipeline中共享同一个ChannelHandler，对应的ChannelHandler必须要使用@Sharable注解标注；否则，试图将它添加到多个ChannelPipeline时将会触发异常。显而易见，为了安全地被用于多个并发的Channel（即连接），这样的ChannelHandler必须是线程安全的。
只应该在确定了你的ChannelHandler是线程安全的时才使用@Sharable注解。
在多个ChannelPipeline中安装同一个ChannelHandler的一个常见的原因是用于收集跨越多个Channel的统计信息。
异常处理
处理入站异常
如果在处理入站事件的过程中有异常被抛出，那么它将从它在ChannelInboundHandler里被触发的那一点开始流经ChannelPipeline。要想处理这种类型的入站异常，你需要在你的ChannelInboundHandler实现中重写下面的方法。
@Overridepublic void exceptionCaught(ChannelHandlerContext ctx, Throwable cause)throws Exception {System.out.println("服务器异常..");cause.printStackTrace();ctx.close();}因为异常将会继续按照入站方向流动（就像所有的入站事件一样），所以实现了前面所示逻辑的ChannelInboundHandler通常位于ChannelPipeline的最后。这确保了所有的入站异常都总是会被处理，无论它们可能会发生在ChannelPipeline中的什么位置。
- ChannelHandler.exceptionCaught()的默认实现是简单地将当前异常转发给ChannelPipeline中的下一个ChannelHandler；
- 如果异常到达了ChannelPipeline的尾端，它将会被记录为未被处理；
- 要想定义自定义的处理逻辑，你需要重写exceptionCaught()方法。然后你需要决定是否需要将该异常传播出去。
处理出站异常
用于处理出站操作中的正常完成以及异常的选项，都基于以下的通知机制。
- 每个出站操作都将返回一个ChannelFuture。注册到ChannelFuture的ChannelFutureListener将在操作完成时被通知该操作是成功了还是出错了 。
- 几乎所有的ChannelOutboundHandler上的方法都会传入一个ChannelPromise的实例。作为ChannelFuture的子类，ChannelPromise也可以被分配用于异步通知的监听器。但是，ChannelPromise还具有提供立即通知的可写方法：
ChannelPromise setSuccess();
ChannelPromise setFailure(Throwable cause);
添加ChannelFutureListener只需要调用ChannelFuture实例上的addListener(ChannelFutureListener)方法，并且有两种不同的方式可以做到这一点。其中最常用的方式是，调用出站操作（如write()方法）所返回的ChannelFuture上的addListener()方法。
方式一：
ChannelFuture future=ctx.writeAndFlush(bufs);future.addListener(new ChannelFutureListener() {@Overridepublic void operationComplete(ChannelFuture future) throws Exception {if (future.isSuccess())System.out.println("成功");else{System.out.println("失败");future.cause().printStackTrace();future.channel().close();}}});方式二：ChannelFutureListener添加到即将作为参数传递给ChannelOutboundHandler的方法的ChannelPromise。
public class OutboundExceptionHandler extends ChannelOutboundHandlerAdapter {@Overridepublic voidwrite(ChannelHandlerContext ctx, Object msg, ChannelPromise promise) {promise.addListener(new ChannelFutureListener() {@Overridepublic voidoperationComplete(ChannelFuturef) {if (!f.isSuccess()) {f.cause().printStackTrace();f.channel().close();}}});}
} ChannelPromise的可写方法
通过调用ChannelPromise上的setSuccess()和setFailure()方法，可以使一个操作的状态在ChannelHandler的方法返回给其调用者时便即刻被感知到。
参考《Netty实战》
附：
package netty.in.action;import io.netty.bootstrap.ServerBootstrap;
import io.netty.buffer.ByteBuf;
import io.netty.buffer.ByteBufAllocator;
import io.netty.buffer.Unpooled;
import io.netty.channel.*;
import io.netty.channel.nio.NioEventLoopGroup;
import io.netty.channel.socket.SocketChannel;
import io.netty.channel.socket.nio.NioServerSocketChannel;import java.nio.charset.Charset;public class EchoServer {final ByteBuf bufs= Unpooled.copiedBuffer("Hello,刘德华", Charset.forName("UTF-8"));public void bind(int port) throws Exception {//配置服务端的NIO线程组EventLoopGroup bossGroup = new NioEventLoopGroup();EventLoopGroup workerGroup = new NioEventLoopGroup();try {ServerBootstrap b = new ServerBootstrap();b.group(bossGroup, workerGroup).channel(NioServerSocketChannel.class).option(ChannelOption.SO_BACKLOG, 100).childHandler(new ChildChannelHandler());// 绑定端口，同步等待成功ChannelFuture f=b.bind(port).sync();//等待服务端监听端口关闭f.channel().closeFuture().sync();} finally {//退出，释放线程池资源bossGroup.shutdownGracefully();workerGroup.shutdownGracefully();}}private class ChildChannelHandler extends ChannelInitializer<SocketChannel> {protected void initChannel(SocketChannel ch) throws Exception {System.out.println("服务端启动……");ch.pipeline().addLast(new ChannelInboundHandlerAdapter() {@Overridepublic void channelRead(ChannelHandlerContext ctx, Object msg)throws Exception {ByteBuf buf = (ByteBuf) msg;if(buf.hasArray()){byte[] array=buf.array();//返回该缓冲区的备份字节数组。int offset=buf.arrayOffset()+buf.readerIndex();//计算第一个字节的偏移量int length=buf.readableBytes();//获取可读字节数String s=new String(array,offset,length);System.out.println("s="+s);}else{byte[] array = new byte[buf.readableBytes()];//获取可读字节数并分配一个新的数组来保存buf.getBytes(buf.readerIndex(),array);//将字节复制到该数组String s=new String(array,0,buf.readableBytes());System.out.println("直接缓冲区:"+s);}byte[] req = new byte[buf.readableBytes()];buf.readBytes(req);String body = new String(req, "UTF-8");System.out.println(body);bufs.retain();//引用计数器加一ChannelFuture future=ctx.writeAndFlush(bufs);future.addListener(new ChannelFutureListener() {@Overridepublic void operationComplete(ChannelFuture future) throws Exception {if (future.isSuccess())System.out.println("成功");else{System.out.println("失败");future.cause().printStackTrace();future.channel().close();}}});
// ctx.close();}});}}public static void main(String[] args) throws Exception {int port=8080;new EchoServer().bind(port);}
}
package netty.in.action;import io.netty.bootstrap.Bootstrap;
import io.netty.buffer.ByteBuf;
import io.netty.buffer.ByteBufProcessor;
import io.netty.buffer.CompositeByteBuf;
import io.netty.buffer.Unpooled;
import io.netty.channel.*;
import io.netty.channel.nio.NioEventLoopGroup;
import io.netty.channel.socket.SocketChannel;
import io.netty.channel.socket.nio.NioSocketChannel;
import io.netty.util.ByteProcessor;import java.nio.charset.Charset;public class EchoClient {final ByteBuf buf= Unpooled.copiedBuffer("Hello,王宝强", Charset.forName("UTF-8"));public void connect(int port, String host) throws Exception {// 配置客户端NIO线程组EventLoopGroup group = new NioEventLoopGroup();try {Bootstrap b = new Bootstrap();b.group(group).channel(NioSocketChannel.class).option(ChannelOption.TCP_NODELAY, true).handler(new ChildChannelHandler() );// 发起异步连接操作ChannelFuture f = b.connect(host, port).sync();// 等待客户端链路关闭f.channel().closeFuture().sync();} finally {// 优雅退出，释放NIO线程组group.shutdownGracefully();}}private class ChildChannelHandler extends ChannelInitializer<SocketChannel> {protected void initChannel(SocketChannel ch) throws Exception {System.out.println("客户端启动……");ByteBuf bufs= Unpooled.copiedBuffer("pipeline发送的数据->", Charset.forName("UTF-8"));ch.pipeline().write(bufs);//通过调用ChannelPipeline的write方法将数据写入通道，但是不刷新ch.pipeline().addLast("text",new ChannelInboundHandlerAdapter() {@Overridepublic void channelActive(ChannelHandlerContext ctx) throws Exception {ctx.channel().write(Unpooled.copiedBuffer("通过ChannelHandlerContext获取的channel发送的消息->",Charset.forName("UTF-8")));//通过ChannelHandlerContext获取的channel发送的消息->CompositeByteBuf messageBuf=Unpooled.compositeBuffer();ByteBuf headerBuf=buf;ByteBuf bodyBuf=buf;messageBuf.addComponent(bodyBuf);//将ByteBuf实例追加到CompositeByteBufmessageBuf.addComponent(headerBuf);for (ByteBuf buf:messageBuf){//遍历所有ByteBufSystem.out.println(buf);byte[] req = new byte[buf.readableBytes()];buf.readBytes(req);String body = new String(req, "UTF-8");System.out.println("复合缓冲区："+body);}ctx.writeAndFlush(buf);}public void channelRead(ChannelHandlerContext ctx, Object msg)throws Exception {ByteBuf buf = (ByteBuf) msg;ByteBuf copyBuf=((ByteBuf) msg).copy();
// System.out.println(buf.refCnt());//返回此对象的引用计数。如果为0，则表示此对象已被释放。
// buf.release();//释放引用计数对象for (int i = 0; i < buf.capacity(); i++) {byte b=buf.getByte(i);if((char)b>='a'&&(char)b<='z'||(char)b>='A'&&(char)b<='Z'||(char)b==',')System.out.println("i="+(char)b);}int i=buf.forEachByte(new ByteProcessor() {@Overridepublic boolean process(byte value) throws Exception {byte[] b=",".getBytes();if (b[0]!=value)return true;elsereturn false;}});System.out.println("i="+i+" value="+(char) buf.getByte(i));ByteBuf sliced = buf.slice(0,2);sliced.setByte(0,(byte)'h');byte[] req = new byte[buf.readableBytes()];buf.readBytes(req);String body = new String(req, "UTF-8");System.out.println(body);ctx.fireChannelRead(copyBuf);}});ch.pipeline().addLast("text2",new ChannelInboundHandlerAdapter(){public void channelRead(ChannelHandlerContext ctx, Object msg)throws Exception {ByteBuf buf = (ByteBuf) msg;byte[] req = new byte[buf.readableBytes()];buf.readBytes(req);String body = new String(req, "UTF-8");System.out.println("text2:"+body);ByteBuf bufs= Unpooled.copiedBuffer("test2发送的数据", Charset.forName("UTF-8"));ctx.writeAndFlush(bufs);ctx.close();}});
// ch.pipeline().remove("text2");}}public static void main(String[] args) throws Exception {int port = 8080;new EchoClient().connect(port, "127.0.0.1");}
}