ChannelHandlerAdapter 与 ChannelInboundHandler 的区别

这两个是 Netty 中不同层次的处理器相关接口/类，主要区别如下：

1. 类型与层级关系

2. 核心区别

ChannelHandlerAdapter：

• 是一个适配器基类（空实现）

• 提供所有 ChannelHandler 方法的默认空实现

• 主要用于不需要处理所有事件的处理器

ChannelInboundHandler：

• 是一个专门处理入站事件的接口

• 定义了入站事件的处理方法（如 channelRead、channelActive 等）

• 需要实现所有入站事件处理方法

3. 典型实现关系

ChannelHandler (接口)
  ↑
ChannelHandlerAdapter (抽象类，空实现)
  ↑
ChannelInboundHandlerAdapter (实现ChannelInboundHandler)
  ↑
SimpleChannelInboundHandler (简化实现)

4. 使用场景对比

使用 ChannelHandlerAdapter 的情况：

• 需要创建自定义处理器基类

• 需要同时处理入站和出站事件

• 只需要处理部分事件

实现 ChannelInboundHandler 的情况：

• 专门处理入站事件（如消息接收、连接建立等）

• 需要明确实现所有入站事件处理方法

• 通常通过继承 ChannelInboundHandlerAdapter 来实现

5. 代码示例对比

ChannelHandlerAdapter 使用方式：

public class CustomHandler extends ChannelHandlerAdapter {
    @Override
    public void channelRead(ChannelHandlerContext ctx, Object msg) {
        

ChannelInboundHandler 实现方式：

public class InboundHandler implements ChannelInboundHandler {
    

6. 实际应用建议

• 大多数情况下：继承 ChannelInboundHandlerAdapter（它已经实现了 ChannelInboundHandler 接口并继承自 ChannelHandlerAdapter）

• 需要最大灵活性时：直接实现 ChannelInboundHandler 接口

• 创建基础处理器时：继承 ChannelHandlerAdapter

关键记忆点：Adapter 是提供默认实现的基类，而 InboundHandler 是定义入站处理规范的接口。