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 事件通常从尾部向头部传播,例如编码响应、加密数据和发送消息。

Pipeline 中常见组件包括:
ChannelHandler:负责处理具体事件,例如解码、业务处理和编码。ChannelHandlerContext:提供 Handler 与 Pipeline 交互的上下文,可以触发事件继续传播。ChannelPipeline:维护 Handler 顺序并控制事件流转。
编写 Inbound Handler 处理请求
Inbound Handler 用于处理进入服务端的数据,例如接收客户端消息、校验参数和执行核心业务。使用 SimpleChannelInboundHandler 时,需要保证 Pipeline 中已经存在对应类型的解码器,否则 Handler 无法收到目标类型的数据。
下面示例假设 Pipeline 已配置 StringDecoder,因此 Handler 可以接收 String 类型消息。
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);
}
}预期输出
receive: helloSimpleChannelInboundHandler 会根据泛型类型完成消息匹配,并在处理结束后自动释放引用,适合明确消息类型的业务处理场景。
理解 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 中存在统一处理入口,避免异常无人消费。
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();
}
}预期结果
发生异常时输出堆栈信息,并关闭当前 Channel合理设计 Pipeline 的关键不是增加更多 Handler,而是让每个 Handler 只承担单一职责。将解码、鉴权、业务处理和编码拆分后,可以降低高并发网络服务中的维护复杂度。