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

   ## 背景与关联
   
   承接总方案 #16。#17 只整理 Native Dubbo 帧、响应类型和 Hessian2 
的**线上协议字节**;客户端还有另一类跨层重复的“名字”:注册中心目录/类别、Provider URL 
参数、消费者注册字段、调用附件与默认路径。它们不应混入 `DubboFrameConstants`,也不宜建全仓通用 `Constants.cs`。本 
Issue 用于管理这组**客户端与注册语义**,允许分多个小 PR 推进。
   
   目前的具体例子(以 PR 时的源码为准):
   
   - `DubboClient` 用 `"/providers"` 解析和识别 ZK 路径,另有 `"providers"` 的节点类别判断;默认根路径 
`"/dubbo"` 也在 `DubboMetadataManager` 出现。这里前者是路径片段,后者是节点名,不能机械统一。
   - `ConsumerRegistration` 写 
`"application"`、`"interface"`、`"version"`、`"group"`、`"consumers"` 及 
`"2.0.2"`;`DubboServiceEndPointInfo` 解析对应 Provider URL 参数,`NativeDubboCodec` 
则写调用附件的部分同名字段。字符串相同未必意味着同一契约。
   - `DubboServiceDriver` 用 `"dubbo"` / `"tri"` 分流;Nacos 的 `"DEFAULT_GROUP"` 与 
ZK 的 `"/dubbo"` 属于不同配置语境。
   
   问题是归属、命名与维护成本,**不是已确认的协议错误**;本 Issue 不改变任何线上字符串、默认行为或公开 API。
   
   ## 分组与可能的文件归属
   
   仅在有多个实际使用点、且语义完全相同的情况下集中定义;目录、名称以小 PR 的差异和依赖为准:
   
   ```text
   Clients/
     RegistryClient/
       RegistryPathConstants.cs      # ZK 根路径和 provider/consumer 节点类别(按实际引用裁剪)
       ConsumerRegistrationKeys.cs  # 消费者 URL / 注册 metadata 字段(只属于这份契约的键)
     DataModle/
       ProviderUrlKeys.cs           # Provider URL 参数键;解析者共享契约时使用
     ...
   DubboService/Native/
     ...                              # RPC 附件键只在拥有该格式的模块内定义,不反向依赖 Clients
   ```
   
   - 协议 scheme (`dubbo`/`tri`)、ZK 路径、Nacos group、Provider URL、消费者注册 
metadata、调用附件分别核对所有者;共享字面值不能单凭拼写推断可以共享类。
   - 可调参数/容量上限、安全预算、业务示例和测试原始字节不是同一种常量,不放进这组定义。`"DEFAULT_GROUP"` 和 `"/dubbo"` 
不合并;需要配置化的问题另起任务。
   - 不批量替换所有字符串;仅在对照实际使用点并写下行为不变量后做迁移。原始外部输入/输出的测试预期不要引用生产常量,以免两边同时改错。
   
   ## 拆分推进(一个 Issue,多个可独立审查的 Draft PR)
   
   1. **注册中心路径/类别**:先列清 ZK 与 Nacos 
的完整生成、识别路径;为真正同义的片段命名,保留根路径规范化和分隔符行为。测试先行,覆盖已有路径生成及 Provider 变更路径的识别。
   2. **Provider URL 与注册字段**:对照解析端与消费者注册端的 wire 字段,分别命名重复且稳定的键;保证 
URL、编码和注册元数据完全不变。用独立字符串预期做回归。
   3. **协议 
scheme/调用附件/默认值**:逐项确认所有者;只抽真正共享的稳定协议名或键。默认值若属于配置政策留在对应配置层;不借常量整理引入新的配置项或修改版本语义。
   4. **核对和收尾**:查漏本范围内重复的跨文件魔法字符串、检查每项的调用方;保留刻意局部的单次使用值,并在本 Issue 勾选实际完成的 PR。
   
   每个 PR 描述引用本 Issue(`Refs #<本 Issue 
编号>`),写明影响文件、测试先行证据和**保持不变**的输出;直到所有子项完成再关闭 Issue。总方案 #16 和 Native 协议常量 #17 不由本 
Issue 自动关闭。
   
   ## 验收
   
   - [ ] 同一注册语义不再在多个生产位置以裸字符串重复;目录和命名反映所属契约,而非万能常量表。
   - [ ] ZK 路径、Nacos group、Provider URL、注册 metadata、调用附件输出与原行为一致;无公开 API 变化。
   - [ ] 各 PR 先有独立期望的测试,相关单测通过;不同协议中仅碰巧同名的值未被错误耦合。
   - [ ] #17 的帧字节、Hessian2 tag 和响应 kind 不重复进入本 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