NeverENG opened a new issue, #17:
URL: https://github.com/apache/dubbo-net/issues/17

   ## 关联与目标
   
   本 Issue 是总方案 #16 的**第一步:建立协议常量的清晰归属**。仅整理 Native Dubbo 
客户端目前使用的线上格式固定值,保持编解码行为不变;后续的调用边界、管理 Hub 和错误分类另行处理。
   
   参考 [dubbo-go 的 Hessian2 
常量组织](https://github.com/apache/dubbo-go/blob/555a9ba6c4c81c6e3a0244b15e966b75e741fa2b/protocol/dubbo/hessian2/const.go):借鉴“按协议归属、按语义命名”,不照搬
 Go 的目录或全局常量表。
   
   ## 现状:协议知识散落在解析分支
   
   
[`DubboHessian2Reader.cs`](https://github.com/apache/dubbo-net/blob/main/DubboService/Native/DubboHessian2Reader.cs)
 在不同位置分别使用 tag 单值、区间和偏移:
   
   ```csharp
   if (tag == (byte)'D' || (tag >= 0x5b && tag <= 0x5f)) // 'D' 即 0x44
   // ...
   case 0x55: // 带类型、长度可变的列表
   // ...
   return (tag >= 0x55 && tag <= 0x58) || (tag >= 0x70 && tag <= 0x7f);
   ```
   
   `0x55` 及相邻 tag 的语义要跨方法对照才能看明白,区间边界和长度计算(如 `tag - 
0x70`)也缺少共同命名。这不是已确认的解码错误,而是维护风险。
   
   
[`NativeDubboCodec.cs`](https://github.com/apache/dubbo-net/blob/main/DubboService/Native/NativeDubboCodec.cs)
 同时持有帧头长度、`0xda/0xbb` Magic、请求/双向/事件标志、序列化掩码,以及响应结果类型 `0–5` 
的分支。它们分别属于帧格式和响应体语义,不宜继续混放在编解码流程里。
   
   ## 范围与文件归属
   
   建议仅引入**内部可见**的、按协议所属划分的定义(目录和类名可在 PR 中微调):
   
   ```text
   DubboService/Native/
     Protocol/
       DubboFrameConstants.cs      # Magic、固定帧长/字段偏移、flags 与 mask、状态和序列化标识
       DubboResponseKinds.cs       # 响应体 result kind 0–5
     Hessian2/
       Hessian2Tags.cs             # 实际使用的 tag、紧凑编码区间边界及基准偏移
     NativeDubboCodec.cs           # 继续负责编解码,不再定义上述分散的协议值
     DubboHessian2Reader.cs        # 继续负责读取,不再内联上述 tag 值
   ```
   
   规则:
   
   - **只命名当前确实使用的值**,保留编码区间的首尾值及计算基准,不为每个可能的字节生成常量。让 `0x44`/`'D'`、`0x55` 
等的协议含义能通过名称直接读出。
   - 不创建全仓库通用的 `Constants.cs`;Dubbo 帧、Hessian2 值、响应 kind 
分开,避免协议间的反向依赖;不为了常量引入额外的管理服务或可变状态。
   - 
`DefaultMaxPayloadLength`、`MaxNormalizedNodes`、`MaxNormalizedJsonBytes`、`MaxNestingDepth`
 是容量/安全限制,**不是线上协议值**;本 Issue 不搬迁或调整它们。相关预算问题归 #9。
   - 单次使用且非协议规范值的局部数字不强行抽取;测试中作为**独立预期**的原始字节值保留,避免测试直接引用实现常量导致同错同过。
   
   ## 推进顺序(可拆为独立 PR)
   
   1. **Hessian2 tag**:整理读取器实际涉及的 tag、连续区间与计算基准;保持各 `Is*Tag`、`Read*` 
分支、引用和异常路径不变。先处理 `0x44`(`'D'`)和 `0x55` 等具代表性的值。
   2. **Dubbo 帧常量**:集中 Magic、16 
字节帧头及字段偏移、flags/mask/序列化标识;替换帧构造与头部校验的对应引用,保持现有对外/测试所用的 internal 契约可用或在同一 PR 
同步迁移引用。
   3. **响应 kind**:给 `0–5` 的分支按当前含义命名(异常、值、空结果及各自携带 attachments 的变体);不改解析顺序或 
`ResultKind` 的现有类型与结果。
   4. **回归验证**:逐 PR 运行相关单测,最后核对同一份输入帧和响应字节得到相同结果。不要把全仓库格式化、异常文案重写或传输行为修复混在常量整理里。
   
   ## 验收标准
   
   - [ ] 编解码逻辑中本范围内的线上协议值通过所属常量表达;Hessian2 tag 单值、范围及基准偏移具有可追溯的名称,无新的“万能常量文件”。
   - [ ] 请求、心跳帧的输出字节、帧头识别与位标志、Hessian2 边界 tag、响应 kind `0–5`、非法 tag/帧头的现有行为保持不变。
   - [ ] 测试覆盖有代表性的字节级用例(至少 `0x44`、`0x55` 及相邻边界、Magic/flags、响应 
kind),预期值独立于生产常量;相关现有测试(如 
`NativeDubboCodecTest`、`HessianResponseSafetyTest`、`NativeDubboConnectionTest`)继续通过。
   - [ ] 不修改公开 API、不改异常类型/文案、不改超时及容量限制;如发现实际行为缺陷,另开 Issue 再修复。
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to