Java 后端 / 系统课时

使用 Netty 编解码器

使用 Netty 编解码器

本节解决 Netty 通信中字节数据与业务对象转换的问题,明确 Pipeline 中编解码器的职责,并掌握从 ByteBuf 到业务对象的正确处理链路。

学习目标

  • 理解 ChannelPipeline 中 Encoder、Decoder 与 ByteBuf 的协作关系
  • 掌握基于 MessageToMessageCodec 和 ByteToMessageDecoder 的编解码设计方式
  • 能够根据协议边界处理完整消息、半包数据和业务转换

Netty 编解码处理流程

网络传输的数据本质是字节流,而业务代码通常处理对象。Netty 通过 Pipeline 中不同 Handler 完成数据转换:入站方向通常由 Decoder 将 ByteBuf 转换为业务对象,出站方向由 Encoder 将对象转换为待发送数据。

Netty 编解码处理流程

编解码器只负责数据格式转换,不应该承担订单处理、权限校验等业务逻辑。业务 Handler 接收转换后的对象后,再执行具体业务操作。

使用 Decoder 转换入站消息

MessageToMessageDecoder 适用于上游 Handler 已经将原始数据转换成指定消息类型的场景。例如前一个 Decoder 已完成字符串解析,当前 Handler 再负责生成业务对象。如果直接处理网络字节流,应优先使用 ByteToMessageDecoder 处理 ByteBuf 和拆包问题。

java
import io.netty.channel.ChannelHandlerContext;
import io.netty.handler.codec.MessageToMessageDecoder;
import java.util.List;

public class UserDecoder extends MessageToMessageDecoder<String> {
    @Override
    protected void decode(ChannelHandlerContext ctx, String message, List<Object> out) {
        // 将已经解析好的消息转换为业务对象
        out.add(new UserMessage(message));
    }

    static class UserMessage {
        private final String value;

        UserMessage(String value) {
            this.value = value;
        }

        public String getValue() {
            return value;
        }
    }
}

预期输出

text
输入消息: client-message
输出对象: UserMessage(value=client-message)

实际生产链路中,常见结构是 ByteToMessageDecoder 负责读取 ByteBuf 并判断消息边界,再交给后续 Handler 完成对象转换。

ByteBuf 的核心使用方式

ByteBuf 是 Netty 对字节缓冲区的抽象,通过 readerIndex 和 writerIndex 分离读写位置,比传统 ByteBuffer 更适合网络场景。

常用概念包括:

概念 作用
readerIndex 当前可读取数据的位置
writerIndex 当前写入数据的位置
readableBytes 当前可读取字节数量

读取数据前需要检查可读长度,避免因为半包数据导致越界读取。

java
import io.netty.buffer.ByteBuf;
import io.netty.buffer.Unpooled;
import java.nio.charset.StandardCharsets;

public class ByteBufDemo {
    public static void main(String[] args) {
        ByteBuf buffer = Unpooled.buffer();
        buffer.writeBytes("netty".getBytes(StandardCharsets.UTF_8));

        byte[] data = new byte[buffer.readableBytes()];
        buffer.readBytes(data);

        System.out.println(new String(data, StandardCharsets.UTF_8));
    }
}

预期输出

text
netty

编解码器设计边界

可靠的 Codec 需要处理协议细节,例如长度字段、消息完整性和异常输入。不要假设一次读取就能获得完整消息,因为 TCP 可能产生半包或粘包。

生产环境使用编解码器时需要注意:

  • Decoder 应明确输入类型,避免 Pipeline 中 Handler 顺序错误。
  • Encoder 输出必须符合通信协议,不能混入业务状态判断。
  • 使用 ByteBuf 时关注引用计数,避免内存泄漏。

将协议解析、数据转换和业务处理分离,可以降低网络服务维护成本,并让问题定位更加清晰。

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

目录与阅读设置

记录一个想法

使用 Netty 编解码器

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

登录哪都通