《Netty 高性能网络编程》6.2 长度域、分隔符与定长解码
LengthFieldBasedFrameDecoder 的五个参数最容易配错。本节用三组真实字节序列算清 lengthFieldOffset、lengthFieldLength、lengthAdjustment 与 initialBytesToStrip,给出 linkd-v2 十六字节头 strip 16 的配置,并对比 LengthFieldPrepender、分隔符与定长解码器。
category
LengthFieldBasedFrameDecoder 的五个参数最容易配错。本节用三组真实字节序列算清 lengthFieldOffset、lengthFieldLength、lengthAdjustment 与 initialBytesToStrip,给出 linkd-v2 十六字节头 strip 16 的配置,并对比 LengthFieldPrepender、分隔符与定长解码器。
粘包拆包都从 ByteToMessageDecoder 开始。本节拆开它的 cumulation 缓冲、callDecode 循环、decodeLast 与 isSingleDecode,给出可运行的行解码器和 linkd-v2 帧解码器,并说明 decode 里 release 入参、读不够却推进 readerIndex、以及用累积缓冲承载超大帧会付出什么代价。
拆开 PooledByteBufAllocator 的 arena、thread cache、chunk、page 结构,用 metric() 读出 arena 分配数与线程缓存命中,验证 4.2 里 ByteBufAllocator.DEFAULT 的真实类型,并给出 linkd-v2 的分配器配置与指标打印代码。
从 readRetainedSlice 的释放责任讲起,给出 retain/release 的所有权规则,说明 SimpleChannelInboundHandler 与 ByteToMessageDecoder 的释放边界,用一个静态 Map 反例复现 LEAK 日志,并整理 paranoid 级别的排查步骤与 ReferenceCountUtil 的使用范围。
用 Unpooled.buffer 把 readerIndex、writerIndex、capacity、maxCapacity 的每次变化跑成表,对照 JDK ByteBuffer 的 position 与 limit,讲清 readableBytes 为什么不能当消息长度,以及 slice、duplicate、retainedSlice 谁共享内容、谁增加引用计数。
本节用 linkd-v2 的 HandshakeHandler 说明哪些字段让 handler 变成有状态,@Sharable 在添加时检查什么,共享实例会带来哪些并发与串状态风险,并给出 AttributeKey、ChannelGroup 与不可变 LinkdFrame 的正确用法,以及 DefaultEventExecutorGroup 的能力边界。
本节按时间顺序拆开 handlerAdded、channelRegistered、channelActive、channelRead、channelReadComplete、channelInactive 与 handlerRemoved,说明 ChannelInitializer 如何移除自己,并用 HandshakeHandler 演示每连接状态迁移。
本节拆开 linkd-v2 的两条 pipeline:head/tail 哨兵、入站与出站方向、addLast 顺序为何决定 HttpServerCodec、HttpObjectAggregator 与业务 handler 的先后,以及 ctx.writeAndFlush() 与 channel().writeAndFlush() 的起点差异。
本节解释为什么 JDBC、文件 IO 和同步 HTTP 不能放在 EventLoop 上,并用本机输出对比三种隔离:DefaultEventExecutorGroup、独立线程池、JDK 25 虚拟线程。给出 GatewayHandler 把转发任务提交到虚拟线程再回写 Channel 的完整代码,以及虚拟线程在 CPU 密集和下游容量上的边界。
本节把 EventLoop 当作单线程调度器来用:execute、schedule、scheduleAtFixedRate 的提交与执行顺序,ChannelFuture 回调里如何安排重连退避,GlobalEventExecutor 与 DefaultEventExecutorGroup 各自适合什么,以及心跳任务写成定时器后为什么会静默停止。给出阻塞任务推迟定时器的本机输出。
本节回答 linkd-v2 上线前的三个问题:boss 与 worker 各开多少线程、一个 Channel 为什么终身只属于一个 EventLoop、group.next() 如何分配连接。用探针打印 channel.eventLoop() 与线程名,给出 10 核机器的真实分配、io.netty.eventLoopThreads 的效果,以及多连接共享 EventLoop 的延迟代价。
ChannelOption 是强类型常量,作用在监听或连接 channel 上。本节拆开 SO_BACKLOG、TCP_NODELAY、SO_KEEPALIVE、CONNECT_TIMEOUT_MILLIS、ALLOCATOR、RCVBUF_ALLOCATOR、WRITE_BUFFER_WATER_MARK 与 AUTO_READ,给出 linkd-v2 参数表和打印 config 的方法。
Channel 从注册到注销经历 registered、active、read、readComplete、inactive、unregistered 六个入站事件,ChannelFuture 串起异步结果与监听器。用 linkd-v2 LifecycleLoggingHandler 与 RegistryHandler 演示事件顺序、closeFuture 关闭、CLOSE 监听器和连接失败处理,说明 sync() 死锁边界。
ServerBootstrap 与 Bootstrap 是两条启动路径:一条接受连接,一条发起连接。拆开 group、childHandler、option、childOption、bind 与 connect 的分工,说明 boss/worker 职责和 ChannelInitializer 每连接执行一次的语义,给出 linkd-v2 LinkdServer 启动与 sync() 线程边界。
本节搭 linkd-v2 四模块 Maven 工程:父 POM 固定 netty.version=4.2.19.Final 与 maven.compiler.release=25,模块保持单向依赖,入口 LinkdV2Main 用 System.Logger 打印协议常量,并给出 mvn -q -DskipTests package 的构建结果与 netty-all 聚合 POM 的验证方法。
本节把卷一 linkd 的 EventLoop、Connection、Handler、BufferPool、FrameDecoder 逐个映射到 Netty 的 EventLoopGroup、Channel、Pipeline、ByteBufAllocator、ByteToMessageDecoder,用对照表和最小 Echo 说明哪些手写逻辑被 Netty 接管,哪些责任仍留在业务代码里。
本节把 Netty 放回一次真实请求的路径里:从 JDK NIO 的 Selector 到 HTTP 协议处理,说明它封装了事件分发、半包与写队列,没封装路由、认证和业务语义;并对比 Tomcat、Jetty、OkHttp 的层次差异,给出 linkd-v2 的四模块划分与 9090 到 9093 的端口分工。
《Netty 高性能网络编程》全书导航:给出协议实现、性能排查、生产网关三条学习路径,十五章分组表与每章首节入口,linkd-v2 四个模块的推进与验收状态,以及 50 篇的阅读顺序、依赖关系、每组能力的自测检查点和附录入口,方便按目标跳读。
交代本书的读者对象与前置知识,列出 Temurin 25.0.5+8、Maven 3.9.12、Netty 4.2.19.Final 的环境清单和 Apple M1 Pro 机器口径,说明 linkd-v2 的四道门禁、端口 9090/9091/9092/9093、代码与输出约定,以及每节内容的验证步骤和常见误解。
从卷一手写 NIO 的 linkd 留下的四个缺口切入,说明为什么还要学 Netty:给出 EventLoop、Channel、Pipeline、ByteBuf 与手写结构的对应关系,交代三卷本定位、Netty 4.2.19.Final 与 JDK 25 的版本口径,以及全书主线 linkd-v2 的验收产出。