C / C++ / 系统课时

用 Codec 隔离协议与连接

用 Codec 隔离协议与连接

当网络库把“收发字节”和“理解协议”写进同一个 TcpConnection,连接层很快就会被长度字段、消息类型和序列化细节污染。本节把这些职责抽到独立 Codec,让连接只负责字节传输,让协议层专注成帧、编解码与消息回调。

学习目标

  • 理解 TcpConnection 与 Codec 的职责边界,避免协议逻辑侵入连接层
  • 掌握“收到字节 → Codec 解码 → 业务回调”和“业务消息 → Codec 编码 → 连接发送”的双向链路
  • 能实现一个最小长度头 Codec,并验证半包与粘包场景

为什么要把协议从连接里拿出去

TcpConnection 最稳定的职责只有两类:维护连接生命周期,以及在 socket 与缓冲区之间搬运字节。至于一条消息如何分帧、头部占几个字节、正文采用什么格式,都属于应用协议。

如果把这些逻辑直接写进 TcpConnection 的读事件处理函数,每增加一种协议就要修改连接类,测试时也很难单独验证编解码规则。更合理的做法是让连接层只暴露“收到字节”和“发送字节”的能力,由 Codec 解释这些字节。

TcpConnection 与 Codec 的职责分层

这种隔离带来的直接收益是连接可复用、协议可替换、测试粒度更小。HTTP、私有二进制协议或 RPC 协议都可以复用同一套连接管理代码,只替换对应的 Codec。

Codec 的最小实现

一个实用 Codec 至少需要两条路径:解码路径接收连接读到的字节并产出完整消息;编码路径接收业务消息并生成待发送字节。下面使用“4 字节大端长度头 + 文本正文”实现一个可运行示例。

cpp
#include <cstdint>
#include <cstring>
#include <iostream>
#include <stdexcept>
#include <string>
#include <vector>

class LengthHeaderCodec {
public:
    std::vector<char> encode(const std::string& message) const {
        const std::uint32_t len = static_cast<std::uint32_t>(message.size());
        std::vector<char> out(4 + message.size());

        // 长度头固定使用大端序,保证通信双方对字节顺序的理解一致。
        out[0] = static_cast<char>((len >> 24) & 0xff);
        out[1] = static_cast<char>((len >> 16) & 0xff);
        out[2] = static_cast<char>((len >> 8) & 0xff);
        out[3] = static_cast<char>(len & 0xff);
        std::memcpy(out.data() + 4, message.data(), message.size());
        return out;
    }

    std::vector<std::string> feed(const std::vector<char>& bytes) {
        buffer_.insert(buffer_.end(), bytes.begin(), bytes.end());
        std::vector<std::string> messages;

        while (buffer_.size() >= 4) {
            const auto b0 = static_cast<std::uint32_t>(static_cast<unsigned char>(buffer_[0]));
            const auto b1 = static_cast<std::uint32_t>(static_cast<unsigned char>(buffer_[1]));
            const auto b2 = static_cast<std::uint32_t>(static_cast<unsigned char>(buffer_[2]));
            const auto b3 = static_cast<std::uint32_t>(static_cast<unsigned char>(buffer_[3]));
            const std::uint32_t len = (b0 << 24) | (b1 << 16) | (b2 << 8) | b3;

            if (len > 1024 * 1024) {
                throw std::runtime_error("frame too large");
            }
            if (buffer_.size() < 4 + len) {
                break; // 半包:保留现有数据,等待下一批字节。
            }

            messages.emplace_back(buffer_.begin() + 4, buffer_.begin() + 4 + len);
            buffer_.erase(buffer_.begin(), buffer_.begin() + 4 + len);
        }
        return messages;
    }

private:
    std::vector<char> buffer_;
};

int main() {
    LengthHeaderCodec codec;
    const auto a = codec.encode("hello");
    const auto b = codec.encode("world");

    // 第一次只送入一帧的前三个字节,模拟半包。
    std::vector<char> first(a.begin(), a.begin() + 3);
    for (const auto& message : codec.feed(first)) {
        std::cout << message << std::endl;
    }

    // 第二次同时送入第一帧剩余部分和完整第二帧,模拟半包恢复与粘包。
    std::vector<char> second(a.begin() + 3, a.end());
    second.insert(second.end(), b.begin(), b.end());
    for (const auto& message : codec.feed(second)) {
        std::cout << message << std::endl;
    }
}

预期输出:

text
hello
world

feed() 没有假设一次 socket read 就得到一条完整消息。它先把字节追加到内部缓冲区,只有当长度头和完整正文都到齐后才产出消息,因此同一套逻辑可以同时处理半包和粘包。

接入 TcpConnection 后怎么分工

真实网络库中,TcpConnection 收到可读事件后,将读取到的数据追加进输入缓冲区,再交给 Codec。Codec 每解出一条完整消息就触发业务回调;发送方向则相反,业务层先提交消息,Codec 编码成字节,再调用连接的发送接口。

连接关闭、重连、背压和高低水位仍属于 TcpConnection;长度校验、消息类型解析、序列化与协议错误则属于 Codec。边界稳定以后,增加新协议通常只需要新增 Codec,而不需要改动连接核心。

解码边界必须明确

Codec 至少要限制最大帧长度,否则恶意或损坏的长度头可能导致缓冲区持续增长。解码遇到非法长度、未知版本或校验失败时,也应定义明确策略,例如关闭连接或报告协议错误,不能让已经失真的解析状态继续影响后续字节。

如果协议以后增加版本号、压缩标志或校验和,这些规则也应继续留在 Codec。判断边界可以归结为一句话:凡是“如何把字节解释成消息”的规则属于协议层,凡是“如何可靠搬运这些字节”的机制属于连接层。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Codec 隔离协议与连接

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

登录哪都通