Netty 入门 — ChannelHandler， Netty 的数据加工厂

通过上篇文章（Netty入门 — Channel，把握 Netty 通信的命门），我们知道 Channel 是传输数据的通道，但是有了数据，也有数据通道，没有数据加工也是没有意义的，所以今天学习 Netty 的第四个组件：ChannelHandler ，它是 Netty 的数据加工厂。

ChannelHandler

在上篇文章（Netty入门 — Channel，把握 Netty 通信的命门）中，大明哥提到：EventLoop 接收到 Channel 的 I/O 事件后会将该事件转交给 Handler 来处理，这个 Handler 就是 ChannelHandler。ChannelHandler 它是对 Netty 输入输出数据进行加工处理的载体，它包含了我们应用程序业务处理的逻辑。

在整个 Netty 生产线上，它就是那个埋头苦干，一心干活的工人。

Channel 的状态处理

在介绍 Channel 的时候（Netty入门 — Channel，把握 Netty 通信的命门）我们知道，Channel 是有状态的，而且 Channel 也提供了判断 Channel 当前状态的 API，如下：

• isOpen()：检查 Channel 是否为 open 状态。
• isRegistered()：检查 Channel 是否为 registered 状态。
• isActive()：检查 Channel 是否为 active 状态。

上面三个 API 对应了 Channel 四个状态：

状态	描述
ChannelUnregistered	Channel 已经被创建，但还未注册到 EventLoop。此时 isOpen() 返回 true，但 isRegistered() 返回 false。
ChannelRegistered	Channel 已经被注册到 EventLoop。此时 isRegistered() 返回 true，但 isActive() 返回 false。
ChannelActive	Channel 已经处理活动状态并可以接收与发送数据。此时 isActive() 返回 true。
ChannelInactive	Channel 没有连接到远程节点

状态变更如下：

当 Channel 的状态发生改变时，会生成相对应的事件，这些事件会被转发给 ChannelHandler，而 ChannelHandler 中会有相对应的方法来对其进行响应。在 ChannelHandler 中定义一些与这生命周期相关的 API，如 channelRegistered() 、channelUnregistered() 、channelActive() 、channelInactive()等等，后面大明哥会详细介绍这些 API。

ChannelHandler 的家族

ChannelHandler 的大家族如下图：

ChannelHandler 是整个家族中的顶层接口，它有两大子接口，ChannelInBoundHandler 和 ChannelOutBoundHandler，其中 ChannelInBoundHandler 用于处理入站数据（读请求），ChannelOutBoundHandler 用于处理出站数据（写请求），他们两个接口都有一个相对应的默认实现，即 XxxxAdapter。

ChannelHandler

ChannelHandler 作为顶层接口，它并不具备太多功能，它仅仅只提供了三个 API：

API	描述
handlerAdded()	当ChannelHandler 添加到 ChannelPipeline 中时被调用
handlerRemoved()	当 ChannelHandler 被从 ChannelPipeline 移除时调用
exceptionCaught()	当 ChannelHandler 在处理过程中出现异常时调用

从 ChannelHandler 提供的 API 中我们可以看出，它并不直接参与 Channel 的数据加工过程，而是用来响应 ChannelPipeline 链和异常处 理的，对于 Channel 的数据加工则由它的子接口处理：

• ChannelInboundHandler：拦截&处理各种入站的 I/O 事件
• ChannelOutboundHandler：拦截&处理各种出站的 I/O 事件

这里解释下出站和入站的概念：

• 接收对方传输的数据并处理，即为入站
• 向对方写数据时，即为出站
• 如：客户端 —> 服务端：服务端读取客户端消息为入站，服务端处理消息完后给客户端返回消息为出站

ChannelInboundHandler

ChannelInboundHandler 用来处理和拦截各种入站的 I/O 事件，它可以处理的事件如下：

响应方法	触发事件
channelRegistered	Channel 被注册到EventLoop 时
channelUnregistered	Channel 从 EventLoop 中取消时
channelActive	Channel 处理活跃状态，可以读写时
channelInactive	Channel 不再是活动状态且不再连接它的远程节点时
channelReadComplete	Channel 从上一个读操作完成时
channelRead	Channel 读取数据时
channelWritabilityChanged	Channel 的可写状态发生改变时
userEventTriggered	ChannelInboundHandler.fireUserEventTriggered()方法被调用时

一般情况我们不直接使用 ChannelInboundHandler,而是使用它的实现类 ChannelInboundHandlerAdapter。我们写业务处理时直接继承 ChannelInboundHandlerAdapter ，然后重写你感兴趣的 I/O 事件响应方法即可，比如你想处理 Channel 读数据，那重写 channelRead() 即可，代码如下：

public class ChannelHandlerTest_1 extends ChannelInboundHandlerAdapter {
    @Override
    public void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception {
        // do something
    }
}

但是在使用 ChannelInboundHandlerAdapter 的时候，需要注意的是我们需要显示地释放与池化 ByteBuf 实例相关的内存，Netty 为此专门提供了一个方法 ReferenceCountUtil.release()，即我们需要在 ChannelInboundHandler 的链的末尾需要使用该方法来释放内存，如下：

public class ByteBufReleaseHandler extends ChannelInboundHandlerAdapter{
  @Override
  public void channelRead(ChannelHandlerContext ctx,Object msg){
    //释放msg
    ReferenceCountUtil.release(msg);
  }
}

但是有些小伙伴有时候会忘记这点，会带来不必要的麻烦，那有没有更好的方法呢？Netty 提供了一个类来帮助我们简化这个过程： SimpleChannelInboundHandler，对于我们业务处理的类，采用继承 SimpleChannelInboundHandler 而不是 ChannelInboundHandlerAdapter 就可以解决了。

public class ChannelHandlerTest_1 extends SimpleChannelInboundHandler<Object> {
    @Override
    public void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception {
        // do something
    }
}

使用 SimpleChannelInboundHandler 我们就不需要显示释放资源了，是不是非常人性化。

ChannelOutboundHandler

ChannelOutboundHandler 是拦截和处理出站的各种 I/O 事件的。处理的事件如下：

响应方法	触发事件
bind	请求将 Channel 绑定到本地地址时
connect	请求将 Channel 连接到远程节点时
disconnect	请求将 Channel 从远程节点断开时
close	请求关闭 Channel 时
dderegister	请求将 Channel 从它的 EventLoop 注销时
read	请求从 Channel 中读取数据时
flush	请求通过 Channel 将入队数据刷入远程节点时
write	请求通过 Channel 将数据写入远程节点时

与 ChannelInboundHandler 一样，我们也不直接使用 ChannelOutboundHandler 接口，而是使用它的默认实现类 ChannelOutboundHandlerAdapter，重写我们想处理的 I/O 事件的响应方法就可以了。

ChannelHandler 的示例

ChannelHandler 生命周期

大明哥通过一个示例来告诉你 ChannelHandler 在整个执行过程中的生命周期是怎么样的，响应方法调用的顺序是如何的。我们只有了解了整个生命周期的运行，才能在合适的生命周期响应方法里面扩展我们自己的业务功能。

• 服务端代码

public class ChannelHandlerTest_1_server extends ChannelInboundHandlerAdapter {
    public static void main(String[] args) {
        new ServerBootstrap()
                .group(new NioEventLoopGroup())
                .channel(NioServerSocketChannel.class)
                .childHandler(new ChannelInitializer<NioSocketChannel>() {
                    @Override
                    protected void initChannel(NioSocketChannel ch) throws Exception {
                        ch.pipeline().addLast(new ChannelHandlerTest());
                    }
                })
                .bind(8081);
    }

    private static class ChannelHandlerTest extends ChannelInboundHandlerAdapter {
        @Override
        public void handlerAdded(ChannelHandlerContext ctx) throws Exception {
            System.out.println(LocalTime.now().toString() + "--handlerAdded：handler 被添加到 ChannelPipeline");
            super.handlerAdded(ctx);
        }

        @Override
        public void channelRegistered(ChannelHandlerContext ctx) throws Exception {
            System.out.println(LocalTime.now().toString() + "--channelRegistered：Channel 注册到 EventLoop");
            super.channelRegistered(ctx);
        }

        @Override
        public void channelActive(ChannelHandlerContext ctx) throws Exception {
            System.out.println(LocalTime.now().toString() + "--channelActive：Channel 准备就绪");
            super.channelActive(ctx);
        }

        @Override
        public void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception {
            System.out.println(LocalTime.now().toString() + "--channelRead：Channel 中有可读数据");

            super.channelRead(ctx, msg);
        }

        @Override
        public void channelReadComplete(ChannelHandlerContext ctx) throws Exception {
            System.out.println(LocalTime.now().toString() + "--channelReadComplete：Channel 读取数据完成");
            super.channelReadComplete(ctx);
        }

        @Override
        public void channelInactive(ChannelHandlerContext ctx) throws Exception {
            System.out.println(LocalTime.now().toString() + "--channelInactive：Channel 被关闭，不在活跃");
            super.channelInactive(ctx);
        }

        @Override
        public void channelUnregistered(ChannelHandlerContext ctx) throws Exception {
            System.out.println(LocalTime.now().toString() + "--channelUnregistered：Channe 从 EventLoop 中被取消");
            super.channelUnregistered(ctx);
        }

        @Override
        public void handlerRemoved(ChannelHandlerContext ctx) throws Exception {
            System.out.println(LocalTime.now().toString() + "--handlerRemoved：handler 从 ChannelPipeline 中移除");
            super.handlerRemoved(ctx);
        }
    }
}

服务端重写整个生命周期中的各个方法。

• 客户端

public class ChannelHandlerTest_1_client extends ChannelInboundHandlerAdapter {
    public static void main(String[] args) throws Exception {
        Channel channel = new Bootstrap()
                .group(new NioEventLoopGroup())
                .channel(NioSocketChannel.class)
                .handler(new ChannelInitializer<NioSocketChannel>() {
                    @Override
                    protected void initChannel(NioSocketChannel ch) throws Exception {
                        ch.pipeline().addLast(new StringEncoder());
                    }
                })
                .connect("127.0.0.1",8081)
                .sync()
                .channel();

        for (int i = 1 ; i <= 2 ; i++) {
            channel.writeAndFlush("hello，i am ChannelHander client -" + i);
            TimeUnit.SECONDS.sleep(2);
        }

        channel.close();
    }
}

客户端连接服务端后，每个 2 秒向服务端发送一次消息，共发两次。发送完消息后，再过 2 秒关闭连接。

• 运行结果

11:45:09.456--handlerAdded：handler 被添加到 ChannelPipeline
11:45:09.457--channelRegistered：Channel 注册到 EventLoop
11:45:09.457--channelActive：Channel 准备就绪

11:45:09.474--channelRead：Channel 中有可读数据
11:45:09.475--channelReadComplete：Channel 读取数据完成

11:45:11.397--channelRead：Channel 中有可读数据
11:45:11.397--channelReadComplete：Channel 读取数据完成

11:45:13.405--channelReadComplete：Channel 读取数据完成
11:45:13.407--channelInactive：Channel 被关闭，不在活跃
11:45:13.407--channelUnregistered：Channe 从 EventLoop 中被取消
11:45:13.407--handlerRemoved：handler 从 ChannelPipeline 中移除

结果分析如下：

• 服务端检测到客户端发起连接后，会将要处理的 Handler 添加到 ChannelPipeline 中，然后将 Channel 注册到 EventLoop，注册完成后，Channel 准备就绪处于活跃状态，可以接收消息了
• 客户端向服务端发送消息，服务端读取消息
• 当服务端检测到客户端已关闭连接后，该 Channel 就被关闭了，不再活跃，然后将该 Channel 从 EventLoop 取消，并将 Handler 从 ChannelPipeline 中移除。

在整个生命周期中，响应方法执行顺序如下：

1. 建立连接：handlerAdded() -> channelRegistered() -> channelActive ()
2. 数据请求：channelRead() -> channelReadComplete()
3. 关闭连接：channelReadComplete() -> channelInactive() -> channelUnregistered() -> handlerRemoved()

这里有一点需要注意，为什么关闭连接会响应 channelReadComplete() 呢？这里埋个点，后续大明哥在来说明，有兴趣的小伙伴可以先研究研究。

这里大明哥对 ChannelHandler 生命周期的方法做一个总结：

1. handlerAdded()：ChannelHandler 被加入到 Pipeline 时触发。当服务端检测到新链接后，会将 ChannelHandler 构建成一个双向链表（下篇文章介绍），该方法被触发表示在当前 Channel 中已经添加了一个 ChannelHandler 业务处理链了》。
2. channelRegistered()：当 Channel 注册到 EventLoop 中时被触发。该方法被触发了，表明当前 Channel 已经绑定到了某一个 EventLoop 中了。
3. channelActive()：Channel 连接就绪时触发。该方法被触发，说明当前 Channel 已经处于活跃状态了，可以进行数据读写了。
4. channelRead()：当 Channel 有数据可读时触发。客户端向服务端发送数据，都会触发该方法，该方法被调用说明有数据可读。而且我们自定义业务 handler 时都是重写该方法。
5. channelReadComplete()：当 Channel 数据读完时触发。服务端每次读完数据后都会触发该方法，表明数据已读取完毕。
6. channelInactive()：当 Channel 断开连接时触发。该方法被触发，说明 Channel 已经不再是活跃状态了，连接已经关闭了。
7. channelUnregistered()：当 Channel 取消注册时触发：连接关闭后，我们就要取消该 Channel 与 EventLoop 的绑定关系了。
8. handlerRemoved()：当 ChannelHandler 被从 ChannelPipeline 中移除时触发。将与该 Channel 绑定的 ChannelPipeline 中的 ChannelHandler 业务处理链全部移除。

ChannelHandler 业务开发

上面只是一个很简单的 ChannelHandler 实例，但是我们在实际项目开发中，要处理的业务复制多了，它肯定是由多个业务组合而成，那我们又该如何去做呢？

一个 ChannelHandler

伪代码如下：

public class ChannelHandlerTest extends ChannelInboundHandlerAdapter {
    @Override
    public void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception {
        Map<String,String> map=(Map<String,String>)msg;
        String code=map.get("code");
        if(code.equals("xxx1")){
            //do something 1
        }else if(code.equals("xxx2")){
            //do something 2
        }else{
            // do something 3
        }
    }
}

这种实现方式简单，非常容易实现，但是如果业务较多的情况下，该 Handler 的处理逻辑会非常臃肿，而且很不好维护，而且这么多 if...else ，看起来就烦，当然我们可以采用相对应的方式来干掉 if...else ，例如利用策略模式：

public class ChannelHandlerTest extends ChannelInboundHandlerAdapter {
    HashMap<String,HandlerService) handlerServiceMap = new HashMap();
    @Override
    public void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception {
        Map<String,String> map=(Map<String,String>)msg;
        String code=map.get("code");
        handlerServiceMap.get(code).doSomething(map);
    }
}

这种方式也行，但他把所有的业务都耦合在一起了，终究不是那么优雅。

多个 ChannelHandler

我们可以定义多个 ChannelHandler，根据 code 来判断，如果 code 是自己的则处理，否则流转到下一个节点：

public class ChannelHandlerTest extends ChannelInboundHandlerAdapter {
    @Override
    public void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception {
        Map<String,String> map=(Map<String,String>)msg;
        String code=map.get("code");
        if(code.equals("xxx")){
            //自己的业务，处理
        }else{
            //不是自己的，流转到下一个节点
            super.channelRead(ctx, msg);
        }
    }
}

这种方式将所有业务解耦了，每个 Handler 各司其职，所有业务不再是都耦合在一起了，后期维护更加轻松。这种方式和上面方式的一样，依赖 code，他们都需要服务端和客户端都维护一套 code，而这个 code 如果还不能轻易发生变更。

自定义类型

根据客户端提交的参数类型，自动流转到相对应的 ChannelHandler。

public class ChannelHandlerTest extends SimpleChannelInboundHandler<User> {
    protected void channelRead0(ChannelHandlerContext channelHandlerContext, User user) throws Exception {
        // do something
    }
}

这种方式是最优雅的，也是我们使用最多的方式。他的优点明显，1. 业务解耦，2. 不需要维护码表。

总结

1. ChannelHandler 是 Netty 中真正做事的组件，EventLoop 将监听到的 I/O 事件转发后，就由 ChannelHandler 来处理，它也是我们编写 Netty 代码最多的地方。
2. ChannelHandler 作为顶层接口，它一般不会负责具体业务 I/O 事件，具体的业务 I/O 事件由它两个子接口负责：
   1. ChannelInboundHandler：负责拦截响应入站 I/O 事件
   2. ChannelOutboundHandler：负责拦截响应出站 I/O 事件
3. 我们自定义的业务 Handler ，一般不会直接实现 ChannelInboundHandler 和 ChannelOutboundHandler，而是继承他们两个的默认实现类：ChannelInboundHandlerAdapter 和 ChannelOutboundHandlerAdapter，这样我们就可以只需要关注我们想关注的 I/O 事件即可。
4. 在这节内容中，最重要的是理解 ChannelHandler 的生命周期方法，在文章总已多次总结了，这里不再阐述了。

虽然 ChannelHandler 是一个好的打工人，但是它没办法一个人干所有的活啊，他需要有其他的 ChannelHandler 来配合它，这个时候怎么办？大明哥下篇文章揭晓！

示例源码：http://suo.nz/1v8w02

---

Java 面试宝典是大明哥全力打造的 Java 精品面试题，它是一份靠谱、强大、详细、经典的 Java 后端面试宝典。它不仅仅只是一道道面试题，而是一套完整的 Java 知识体系，一套你 Java 知识点的扫盲贴。

它的内容包括：

• 大厂真题：Java 面试宝典里面的题目都是最近几年的高频的大厂面试真题。
• 原创内容：Java 面试宝典内容全部都是大明哥原创，内容全面且通俗易懂，回答部分可以直接作为面试回答内容。
• 持续更新：一次购买，永久有效。大明哥会持续更新 3+ 年，累计更新 1000+，宝典会不断迭代更新，保证最新、最全面。
• 覆盖全面：本宝典累计更新 1000+，从 Java 入门到 Java 架构的高频面试题，实现 360° 全覆盖。
• 不止面试：内容包含面试题解析、内容详解、知识扩展，它不仅仅只是一份面试题，更是一套完整的 Java 知识体系。
• 宝典详情：https://www.yuque.com/chenssy/sike-java/xvlo920axlp7sf4k
• 宝典总览：https://www.yuque.com/chenssy/sike-java/yogsehzntzgp4ly1
• 宝典进展：https://www.yuque.com/chenssy/sike-java/en9ned7loo47z5aw

目前 Java 面试宝典累计更新 400+ 道，总字数 42w+。大明哥还在持续更新中，下图是大明哥在 2024-12 月份的更新情况：

想了解详情的小伙伴，扫描下面二维码加大明哥微信【daming091】咨询

同时，大明哥也整理一套目前市面最常见的热点面试题。微信搜[大明哥聊 Java]或扫描下方二维码关注大明哥的原创公众号[大明哥聊 Java] ，回复【面试题】 即可免费领取。