Java 后端 / 系统课时

实现协议通信案例

实现协议通信案例

本节通过一个完整的小型案例,将自定义协议应用到 Netty 客户端和服务端通信中。最终实现消息编码、网络传输、协议解析和响应返回,帮助理解协议通信的完整链路。

学习目标

  • 掌握 Netty 中自定义协议编码和解码的基本实现方式
  • 理解客户端与服务端按照协议交互时的数据流转过程
  • 能够定位长度字段、半包数据等常见通信问题

实现通信流程

自定义协议通信通常包含编码、传输、解码和业务处理四个阶段。发送方将业务对象转换为字节流,接收方根据协议规则恢复原始消息。

Netty 通过 ChannelPipeline 组织处理链,将编码器和解码器放入对应阶段,使业务处理器接收到的是已经解析完成的对象,而不是底层字节数据。

Netty协议通信流程示意图

编写消息编码器

编码器负责把业务消息转换为协议定义的字节格式。本案例采用简单协议:前 4 个字节保存消息长度,后续字节保存消息正文。

java
import java.nio.charset.StandardCharsets;

public class MessageEncoder {
    public byte[] encode(String content) {
        byte[] body = content.getBytes(StandardCharsets.UTF_8);
        byte[] data = new byte[4 + body.length];
        int length = body.length;

        // 使用固定长度字段记录消息正文大小
        data[0] = (byte) (length >> 24);
        data[1] = (byte) (length >> 16);
        data[2] = (byte) (length >> 8);
        data[3] = (byte) length;

        System.arraycopy(body, 0, data, 4, body.length);
        return data;
    }
}

预期输出

text
输入消息: hello
生成字节数组: 4字节长度字段 + UTF-8消息正文

编写消息解码器

解码器需要处理网络传输中的半包问题。一次读取不一定包含完整消息,因此不能直接读取正文,而应该先判断 ByteBuf 中是否已经包含完整长度的数据。

下面是基于 Netty ByteToMessageDecoder 上下文中的片段示例。buffer 由 Netty 框架传入,框架负责持续接收网络数据并在数据可读时触发 decode 方法。

java
@Override
protected void decode(ChannelHandlerContext ctx, ByteBuf buffer, List<Object> out) {
    if (buffer.readableBytes() < 4) {
        return;
    }

    // 标记当前位置,数据不足时恢复,等待下一次读取
    buffer.markReaderIndex();
    int bodyLength = buffer.readInt();

    if (buffer.readableBytes() < bodyLength) {
        buffer.resetReaderIndex();
        return;
    }

    String message = buffer.readCharSequence(bodyLength, StandardCharsets.UTF_8).toString();
    out.add(message);
}

预期结果

text
读取长度字段成功
检测消息正文长度完整
生成业务消息对象并交给后续处理器

验证客户端服务端交互

启动服务端后,客户端按照协议发送编码后的字节数据。服务端经过解码器恢复消息,再由业务处理器生成响应。

验证时重点检查消息长度、字段顺序和异常输入处理逻辑,确保客户端和服务端使用完全一致的协议定义。

bash
java Client --host <HOST> --port <PORT>

预期输出

text
CONNECT SUCCESS
SEND MESSAGE SUCCESS
RECEIVE RESPONSE SUCCESS

处理协议通信中的常见问题

协议通信失败时,应优先确认双方协议定义是否一致。字段顺序错误会导致解析异常,长度计算错误可能造成等待超时或消息截断。

生产环境还需要增加消息类型校验、最大消息长度限制和异常关闭策略,避免恶意或错误数据影响服务稳定性。

完成该案例后,客户端和服务端可以在稳定协议基础上继续扩展更多业务消息类型,同时保持通信双方独立演进。

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

目录与阅读设置

记录一个想法

实现协议通信案例

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

登录哪都通