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

   ## 背景与关联
   
   关联总方案 #16、协议常量任务 #17。本任务与 #17 **一起在 Draft PR #18 中推进**:#17 
负责命名固定协议值,本任务负责明确字节读取的所有权。不是要求再创建一个叠加 PR。
   
   当前 
[`DubboHessian2Reader.cs`](https://github.com/apache/dubbo-net/blob/main/DubboService/Native/DubboHessian2Reader.cs)
 同时持有 `_buffer`/`_position`,实现 `PeekByte`、`ReadByte`、大端整数、越界检查,又维护 
`_references`、`_typeReferences`、`_classDefinitions` 并组装 Hessian2 对象。列表、Map 
消费结束标记和二进制分块时还有直接操作 `_position`/`_buffer` 的路径。常量命名后,字节游标与协议语义仍未分离。
   
   ## 目标边界
   
   在 `DubboService/Native/Hessian2/` 中建立一个**内部、只管理字节的读取组件**(建议 
`Hessian2ByteReader.cs`):唯一持有缓冲区及读取位置,提供逐字节读取/预览、剩余字节数、有界读取/拷贝、固定宽度大端数读取,并统一处理越界。`DubboHessian2Reader`
 保留 tag 分派、紧凑编码解释、UTF-8 字符串语义、列表/对象/引用、嵌套深度和计数策略;不再直接访问缓冲区或改游标。
   
   该组件**不认识 Hessian2 tag,也不负责 `tag - base`、对象模型或通用错误分类**;暂不扩展到 Dubbo 
帧/Triple/Telnet。避免为拆层而增加不必要的接口、缓存或第二套位置状态。建议结构:
   
   ```text
   DubboService/Native/
     Hessian2/
       Hessian2Tags.cs             # #17:固定线上值
       Hessian2ByteReader.cs       # 本任务:有界字节读取与游标所有权
     DubboHessian2Reader.cs        # Hessian2 值与引用语义
   ```
   
   ## 测试先行与实施顺序
   
   1. 先用独立原始字节测试锁定 `Peek` 
不消费、顺序读取与剩余长度、固定宽度大端值、精确有界拷贝、空/负长度与截断异常、读取失败后位置不变;补足跨块和结束标记仍能连续读取的读取器级用例。
   2. 新组件集中 `_buffer`/`_position` 
与越界检查;逐步替换读取器中的原始读、手工跳过、`EnsureCountFitsPayload` 的剩余长度计算和 binary chunk 
的直接拷贝。保留现有异常类型及文案、`ReadInt`/`ReadString`/`ReadValue` 的内部契约及公共 API。
   3. 逐阶段验证 Native/Hessian2 
相关单测、完整单测及构建;对环境导致的基线失败明确记录,不夹带修复。不做全仓格式化、错误重构或容量限制调整(#9)。
   
   ## 验收
   
   - [ ] 唯一的缓冲区及游标所有者是字节读取组件;值读取器中不直接读写 
`_buffer`/`_position`,结束标记与二进制分块通过同一边界消费。
   - [ ] 原始字节测试先于迁移实现提交,证明正常值、截断、越界和位置语义不变;现有相关单测继续通过。
   - [ ] 不改变协议字节、引用和列表行为、异常类型/文案、公开 API、容量上限;PR 保持 Draft,待边界和验证结果审查后再转 Ready。
   


-- 
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