深入解析Terry-Mao/goim项目中的通信协议设计-CSDN博客

本文链接：https://blog.csdn.net/gitblog_01158/article/details/148464363

深入解析Terry-Mao/goim项目中的通信协议设计

goim goim 项目地址: https://gitcode.com/gh_mirrors/go/goim

项目概述

Terry-Mao/goim是一个高性能的即时通讯服务框架，其核心组件comet负责处理客户端连接和消息转发。本文将详细解析comet模块支持的两种客户端通信协议：WebSocket和TCP，帮助开发者深入理解其设计原理和实现细节。

WebSocket通信协议详解

协议基础

WebSocket协议是现代Web应用中常用的全双工通信协议，goim项目通过JSON格式的帧结构来实现客户端与服务端的交互。

协议格式

{
    "ver": 102,
    "op": 10,
    "seq": 10,
    "body": {"data": "xxx"}
}

字段说明

ver（协议版本号）
- 类型：整型
- 作用：标识协议版本，便于后续协议升级和兼容性处理
op（操作指令）
- 类型：整型
- 作用：定义当前帧的操作类型，如心跳、认证等
seq（序列号）
- 类型：整型
- 作用：保证请求与响应的对应关系，实现异步通信的有序性
body（消息体）
- 类型：字符串/JSON对象
- 作用：承载实际业务数据，内容根据操作指令不同而变化

连接建立

客户端通过标准的WebSocket握手过程建立连接，请求URL格式为：

ws://DOMAIN/sub

TCP二进制协议详解

协议特点

TCP协议提供了更高效的二进制数据传输方式，适合对性能要求更高的场景。

协议格式

采用二进制格式，包含固定长度的包头和可变长度的包体：

Package Length（4字节）
- 字节序：大端
- 作用：标识整个数据包的长度
Header Length（2字节）
- 字节序：大端
- 作用：标识包头部分的长度
ver（2字节）
- 字节序：大端
- 作用：协议版本号
operation（4字节）
- 字节序：大端
- 作用：操作指令类型
seq（4字节）
- 字节序：大端
- 作用：序列号
body（可变长度）
- 类型：二进制数据
- 长度计算：Package Length - Header Length

核心指令解析

goim定义了一套精简而高效的指令集，用于处理各种通信场景：

| 指令值 | 名称 | 方向 | 说明 | |--------|---------------|-------------|----------------------------------------------------------------------| | 2 | 心跳请求 | 客户端→服务端 | 客户端定期发送以保持连接活跃 | | 3 | 心跳响应 | 服务端→客户端 | 服务端对心跳请求的确认 | | 5 | 下行消息 | 服务端→客户端 | 服务端向客户端推送的消息 | | 7 | 认证请求 | 客户端→服务端 | 客户端发送认证信息以建立合法连接 | | 8 | 认证响应 | 服务端→客户端 | 服务端返回认证结果 |