Java 后端 / 系统课时
实现协议通信案例
实现协议通信案例
本节通过一个完整的小型案例,将自定义协议应用到 Netty 客户端和服务端通信中。最终实现消息编码、网络传输、协议解析和响应返回,帮助理解协议通信的完整链路。
学习目标
- 掌握 Netty 中自定义协议编码和解码的基本实现方式
- 理解客户端与服务端按照协议交互时的数据流转过程
- 能够定位长度字段、半包数据等常见通信问题
实现通信流程
自定义协议通信通常包含编码、传输、解码和业务处理四个阶段。发送方将业务对象转换为字节流,接收方根据协议规则恢复原始消息。
Netty 通过 ChannelPipeline 组织处理链,将编码器和解码器放入对应阶段,使业务处理器接收到的是已经解析完成的对象,而不是底层字节数据。

编写消息编码器
编码器负责把业务消息转换为协议定义的字节格式。本案例采用简单协议:前 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处理协议通信中的常见问题
协议通信失败时,应优先确认双方协议定义是否一致。字段顺序错误会导致解析异常,长度计算错误可能造成等待超时或消息截断。
生产环境还需要增加消息类型校验、最大消息长度限制和异常关闭策略,避免恶意或错误数据影响服务稳定性。
完成该案例后,客户端和服务端可以在稳定协议基础上继续扩展更多业务消息类型,同时保持通信双方独立演进。
按自己的节奏,确认真正理解。