JsonStream

Appearance

面试题要求 ​

本文归档题面原文：分组与条目原样保留，不混入解题思路；每条的实现现状在文末「实现现状」一节逐条对照，附代码与文档依据。解题思路与设计权衡见 design-notes.md、DESIGN.md，本文不重复。

题面原文 ​

  • 传输可靠性与容错性
    • 基于 TCP
    • 支持断线重连恢复
    • 支持心跳机制
  • 便捷性
    • 以 JSON 为交互数据
  • 高性能
    • 二进制帧
    • 支持参数化是否启用压缩
    • 支持分包传输（大数据量场景）
    • 支持合并包之后解包（大数据量场景）
    • 支持分包传输/分片（大数据量场景，最好支持分片传输）
  • 安全性
    • 支持可选是否启用加密
  • 灵活性
    • 支持请求/响应模式
    • 支持发布/订阅模式
    • 支持流式传输
    • 支持双工
    • 支持单向发送，无需返回
    • 支持返回错误
    • 支持可选背压
  • 工程要求
    • 对应的测试用例
    • 性能测试
    • 完整的使用例子
    • 相关说明文档

实现现状（非题面） ​

以下逐条对照不是题面内容，是本仓库对每一条的实现现状标注，口径以代码事实为准。

分帧三条的详细现状（分包 / 合并包 / 分片） ​

题面「高性能」组最后三条围绕同一件事：TCP 字节流上如何承载大数据量。三者现状不同，分开说：

  • 支持合并包之后解包——已完整覆盖。TCP 字节流的粘包/半包正是本协议分帧设计的正面战场：14B 定长头 + 32 位大端长度前缀，解码端 io.ReadFull 两段读（先读满头、再按长度读满载荷），transport.readLoop 外层再包一层 16 KiB bufio。粘包（多帧挤在一次读里）由缓冲批量取字节解决，半包（一帧分多次到达）由 ReadFull 内部循环消化，两个机制职责不同、不可互替。代码位置：frame.go:168（ReadFrame）、transport.go:175（readLoop）；专节讨论见 NOTES.md §3、DESIGN.md §7。
  • 支持分包传输/分片——规范已定稿，实现落地中。分片已写进单一事实源（protocol.md §3.4）：FRAGMENT 帧类型（0x10）+ FlagFragmented 标志位，变换后超单帧上限（16 MiB）的消息自动拆成连续 chunk 运行，重组总量帽 MaxMessageSize（默认 64 MiB），运行不可穿插故无需块序号，资源防线（总量/并发重组数/停滞超时）全部以断开收场。这是对早期「16 MiB 内一帧装得下、省掉状态机」决策的正式翻案，生产场景不能「包体过大就拒传」；两次决策的理由都留档在 design-notes.md §1.2。Go 参考实现的分片代码尚未合入 main，当前版本收到 FlagFragmented 帧按保留位违规断开；实现合入后本条与 websocket-comparison.md §① 同步转为「已覆盖」。
  • 分包传输（大数据量场景）——与上一条同指：规范口径见 protocol.md §3.4；16 MiB 内的消息不受分片影响（单帧直发，编码与历史逐字节一致），超出部分在实现合入 main 前仍不可用。

其余各条逐项对照 ​

题面条目实现现状依据
基于 TCP完整支持：裸 TCP 直连（net.Dialer / net.Listener）transport.go、client.go:279
支持断线重连恢复完整支持：会话保留 + 原序重放（at-least-once）、takeover、订阅自动重订protocol.md §8、client.go（connectLoop）
支持心跳机制完整支持：双向 PING/PONG，读空闲 1.5× 间隔判死protocol.md §7.2、transport.go:148
以 JSON 为交互数据完整支持：payload 语义恒为 UTF-8 JSON；路由/主题在 Metadataprotocol.md §5
二进制帧完整支持：14B 定长头 + 32 位大端长度前缀protocol.md §3、frame.go
支持参数化是否启用压缩完整支持：握手协商生效，每帧 Flags 声明，载荷 ≥64B 才实际压protocol.md §6、transform.go:74
支持可选是否启用加密完整支持：AES-256-GCM + 32B PSK，先压后加，每帧独立标注protocol.md §6、transform.go
支持请求/响应模式完整支持：REQUEST→RESPONSE，响应帧自带终结语义protocol.md §7.4
支持发布/订阅模式完整支持：SUBSCRIBE/SUBACK/PUBLISH，主题是双向命名空间protocol.md §7.8
支持流式传输完整支持：Flags.Stream，N×RESPONSE + 恰一个终结帧protocol.md §7.5
支持双工完整支持：Flags.Channel，同一 Stream ID 双向复用，半关闭语义protocol.md §7.6
支持单向发送，无需返回完整支持：ONEWAY 永不产生任何响应帧（含错误）protocol.md §7.7
支持返回错误完整支持：ERROR 帧 + 十个错误码 + 「哪层错误决定是否断连」惯例protocol.md §7.10、errors.go
支持可选背压完整支持：credit 连接级窗口，默认关闭，交付应用后归还protocol.md §7.9、credit.go
对应的测试用例已交付：212 个测试/基准/fuzz 函数，库包与示例包覆盖率 100% 且有 CI 门禁README「性能基准摘要」的质量与验证口径段
性能测试已交付：bench 套件（帧编解码/变换管线/回环 RTT）README 性能表
完整的使用例子已交付：examples/client + examples/server 端到端跑全部模式examples/
相关说明文档已交付：协议规范、设计、知识点、对照等 docs/ 全套 + 在线站点docs/、https://cuihairu.github.io/jsonstream/

基于 MIT 许可发布

Copyright © 2024-present cuihairu