Netty(ChannelHandler 和 ChannelPipeline)
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()方法的调用
*/
@Override
ChannelHandlerContext fireChannelRegistered();
/**
* 触发对下一个ChannelInboundHandler上的fireChannelUnregistered()方法的调用
*/
@Override
ChannelHandlerContext fireChannelUnregistered();
/**
* 触发对下一个ChannelInboundHandler上的fireChannelActive()方法的调用
*/
@Override
ChannelHandlerContext fireChannelActive();
/**
* 触发对下一个ChannelInboundHandler上的fireChannelInactive()方法的调用
*/
@Override
ChannelHandlerContext fireChannelInactive();
/**
* 触发对下一个ChannelInboundHandler上的fireExceptionCaught()方法的调用
*/
@Override
ChannelHandlerContext fireExceptionCaught(Throwable cause);
/**
* 触发对下一个ChannelInboundHandler上的fireUserEventTriggered()方法的调用
*/
@Override
ChannelHandlerContext fireUserEventTriggered(Object evt);
/**
* 触发对下一个ChannelInboundHandler上的fireChannelRead()方法的调用
*/
@Override
ChannelHandlerContext fireChannelRead(Object msg);
/**
* 触发对下一个ChannelInboundHandler上的fireChannelReadComplete()方法的调用
*/
@Override
ChannelHandlerContext fireChannelReadComplete();
/**
* 触发对下一个ChannelInboundHandler上的fireChannelWritabilityChanged()方法的调用
*/
@Override
ChannelHandlerContext fireChannelWritabilityChanged();
/**
* 将数据从Channel读取到第一个入站缓冲区；如果读取成功则触发一个channelRead事件，并（在最后一个消息被读取完成后）通知ChannelInboundHandler的channelReadComplete(ChannelHandlerContext)方法
*/
@Override
ChannelHandlerContext read();
/**
* 刷新所有挂起的消息。
*/
@Override
ChannelHandlerContext flush();
/**
* 返回这个实例所关联的ChannelPipeline
*/
ChannelPipeline pipeline();
/**
* 返回和这个实例相关联的Channel所配置的ByteBufAllocator
*/
ByteBufAllocator alloc();
/******************补充*************************/
//write 通过这个实例写入消息并经过ChannelPipeline
//writeAndFlush 通过这个实例写入并冲刷消息并经过ChannelPipeline
}使用ChannelHandlerContext的API的时候，请牢记以下两点：
- ChannelHandlerContext和ChannelHandler之间的关联（绑定）是永远不会改变的，所以缓存对它的引用是安全的；
- 相对于其他类的同名方法，ChannelHandlerContext的方法将产生更短的事件流，应该尽可能地利用这个特性来获得最大的性能。
使用 ChannelHandlerContext
修改客户端的ChildChannelHandler：
private class ChildChannelHandler extends ChannelInitializer {
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() {
@Override
public 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实例追加到CompositeByteBuf
messageBuf.addComponent(headerBuf);
for (ByteBuf buf:messageBuf){//遍历所有ByteBuf
System.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() {
@Override
public boolean process(byte value) throws Exception {
byte[] b=",".getBytes();
if (b[0]!=value)
return true;
else
return 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实现中重写下面的方法。
@Override
public 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() {
@Override
public 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 {
@Override
public void
write(ChannelHandlerContext ctx, Object msg, ChannelPromise promise) {
promise.addListener(new ChannelFutureListener() {
@Override
public void
operationComplete(ChannelFuture
f) {
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 {
protected void initChannel(SocketChannel ch) throws Exception {
System.out.println("服务端启动……");
ch.pipeline().addLast(new ChannelInboundHandlerAdapter() {
@Override
public 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() {
@Override
public 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 {
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() {
@Override
public 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实例追加到CompositeByteBuf
messageBuf.addComponent(headerBuf);
for (ByteBuf buf:messageBuf){//遍历所有ByteBuf
System.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() {
@Override
public boolean process(byte value) throws Exception {
byte[] b=",".getBytes();
if (b[0]!=value)
return true;
else
return 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");
}
}