Java 后端 / 系统课时

掌握 Pipeline 处理链

掌握 Pipeline 处理链

Netty Pipeline 负责组织网络事件与业务处理逻辑。本课将理解 Handler 链路的组成方式,掌握 Inbound 与 Outbound 事件传播方向,并能够编写可运行的 Handler 处理流程。

学习目标

  • 理解 ChannelPipeline、ChannelHandler 和 ChannelHandlerContext 的职责关系
  • 掌握 Inbound 与 Outbound Handler 的执行方向
  • 能够编写 Handler 并验证事件传播过程

理解 Pipeline 的核心组成

Netty 中每个 Channel 都关联一个 ChannelPipeline。Pipeline 按顺序管理多个 Handler,负责将网络事件传递给对应处理器。

Inbound 事件通常从 Pipeline 头部向尾部传播,例如读取客户端数据、解码消息和执行业务逻辑;Outbound 事件通常从尾部向头部传播,例如编码响应、加密数据和发送消息。

Netty Pipeline 双向事件传播模型

Pipeline 中常见组件包括:

  • ChannelHandler:负责处理具体事件,例如解码、业务处理和编码。
  • ChannelHandlerContext:提供 Handler 与 Pipeline 交互的上下文,可以触发事件继续传播。
  • ChannelPipeline:维护 Handler 顺序并控制事件流转。

编写 Inbound Handler 处理请求

Inbound Handler 用于处理进入服务端的数据,例如接收客户端消息、校验参数和执行核心业务。使用 SimpleChannelInboundHandler 时,需要保证 Pipeline 中已经存在对应类型的解码器,否则 Handler 无法收到目标类型的数据。

下面示例假设 Pipeline 已配置 StringDecoder,因此 Handler 可以接收 String 类型消息。

java
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.SimpleChannelInboundHandler;

public class MessageHandler extends SimpleChannelInboundHandler<String> {
    @Override
    protected void channelRead0(ChannelHandlerContext ctx, String message) {
        // 处理业务消息,并继续向后发送响应
        System.out.println("receive: " + message);
        ctx.writeAndFlush("server reply: " + message);
    }
}

预期输出

text
receive: hello

SimpleChannelInboundHandler 会根据泛型类型完成消息匹配,并在处理结束后自动释放引用,适合明确消息类型的业务处理场景。

理解 Outbound Handler 的传播方向

Outbound Handler 处理服务端发送给客户端的数据,例如编码、压缩和加密。它的执行方向与 Inbound 相反,不是按照添加顺序从前向后执行,而是从当前位置向前查找匹配的 Outbound Handler。

例如 Pipeline 中包含以下处理器:

顺序 Handler 类型
1 Decoder Inbound
2 BusinessHandler Inbound
3 Encoder Outbound

客户端发送消息时,会经过 Decoder 和 BusinessHandler;服务端调用写操作返回数据时,会经过 Encoder。

管理 Handler 生命周期与异常传播

Handler 还可以监听 Channel 生命周期事件。常用方法包括:

  • channelActive:连接建立后触发。
  • channelInactive:连接关闭后触发。
  • exceptionCaught:异常发生时触发。

异常处理通常需要保证 Pipeline 中存在统一处理入口,避免异常无人消费。

java
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.ChannelInboundHandlerAdapter;

public class ExceptionHandler extends ChannelInboundHandlerAdapter {
    @Override
    public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) {
        cause.printStackTrace();
        ctx.close();
    }
}

预期结果

text
发生异常时输出堆栈信息,并关闭当前 Channel

合理设计 Pipeline 的关键不是增加更多 Handler,而是让每个 Handler 只承担单一职责。将解码、鉴权、业务处理和编码拆分后,可以降低高并发网络服务中的维护复杂度。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

掌握 Pipeline 处理链

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通