Netty入门(3) - ChannelHandler

ChannelPipeline

ChannelHandler实例的列表，用于处理或者截获通道的接收和发送数据，让用户可以在ChannelPipeline中完全控制一个事件以及处理ChannelHandler和ChannelPipeline的交互。

每一个新的通道，都会创建一个新的ChannelPipeline并且附加到通道，永久性的耦合。

一个入站I/O事件，这个事件会从ChannelPipeline的第一个Handler开始一次通过，出站IO事件则从最后一个Handler开始依次通过。Handler可以处理时间并检查类型，不能处理则跳过，并将事件传递给下一个Handler。

我们找到，不能有其他IO-Thread的阻塞拉力影响整体的IO处理，比如JDBC。这时候可以通过一个EventExecutorGroup，自定义的事件会被包含在EventExecutorGroup的EventExecutor处理。

ChannelHandlerContext

通过context，ChannelHandler允许与其他ChannelHandler实现交互：

1、通知下一个ChannelHandler

2、想事件流全部通过ChannelPipeline，可以通过调用Channel和ChannelPipeline的方法：

3、想事件从ChannelPipeline的指定位置开始：

ChannelHandlerContext是线程安全的，可以在外部使用。

修改ChannelPipeline

调用ChannelHandlerContext的pipeline()方法能访问ChannelPipeline，可以运行时动态调整ChannelHandler。可以保持ChannelHandlerContext供以后使用，线程安全：

public class WriteHandler extends ChannelHandlerAdapter {

    private ChannelHandlerContext ctx;

    @Override
    public void handlerAdded(ChannelHandlerContext ctx) throws Exception {
        this.ctx = ctx;
    }

    public void send(String msg) {
        ctx.write(msg);
    }

}

如果ChannelHandler实例带有@Sharable注解则可以被添加到多个ChannelPipeline中，也就是说单个ChannelHandler可以有多个ChannelHandlerContext；如果没有添加该注解的Handler实例添加到多个Pipeline中则会抛异常：

@Sharable
public class NotSharableHandler extends ChannelInboundHandlerAdapter {

    private int count;

    @Override
    public void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception {
        count++;
        System.out.println("channelRead(...) called the " + count + " time");
        ctx.fireChannelRead(msg);
    }
}

ChannelHandler及其子类

ChannelHandlerAdapter

ChannelInboundHandler / ChannelInboundHandlerAdapter 处理完消息之后不会自动释放，需要ReferenceCountUtil.release(msg);

ChannelOutboundHandler / ChannelOutboundHandlerAdapter

SimpleChannelInboundHandler<T> / SimpleChannelInboundHandler<T> 处理完消息之后自动释放

ChannelOutboundHandler所有重要方法采用ChannelPromise，如果ChannelPromise没有被通知，可能会导致其中一个ChannelFutureListener没有被通知去处理一个消息：

public class DiscardOutboundHandler extends ChannelOutboundHandlerAdapter {

    @Override
    public void write(ChannelHandlerContext ctx, Object msg, ChannelPromise promise) throws Exception {
        ReferenceCountUtil.release(msg);
        promise.setSuccess();
    }

}

总结一下：一般自定义消息，使用编码解码器实现字节传输，使用ChannelInboundHandlerAdapter/ChannelOutboundHandlerAdapter处理事件或者状态改变，使用SimpleChannelInboundHandler/SimpleChannelOutboundHandler处理消息。