NeverENG commented on issue #20: URL: https://github.com/apache/dubbo-net/issues/20#issuecomment-6610159871
## 补充调研:按语言特性管理常量归属(供 #20 后续 PR 参考) 这一步的目标不是再建一个全局 `Common/Constants`,而是分清**共享注册语义、具体注册中心的表示形式、实现内部的局部值**。本评论补充 #20 的设计判断,不扩大已经提交的 PR #22 范围,也不修改线上字符串、默认行为或公开 API。 ### 对照 Java Dubbo 与 dubbo-go - **Java Dubbo** 不是所有值都集中在 `dubbo-common`:真正共享的注册类别放在 [`dubbo-common/.../RegistryConstants.java`](https://github.com/apache/dubbo/blob/3.3/dubbo-common/src/main/java/org/apache/dubbo/common/constants/RegistryConstants.java);协议模块有自己的 [`Constants.java`](https://github.com/apache/dubbo/blob/3.3/dubbo-rpc/dubbo-rpc-dubbo/src/main/java/org/apache/dubbo/rpc/protocol/dubbo/Constants.java);响应类型就近定义在 [`DubboCodec.java`](https://github.com/apache/dubbo/blob/3.3/dubbo-rpc/dubbo-rpc-dubbo/src/main/java/org/apache/dubbo/rpc/protocol/dubbo/DubboCodec.java),帧头/Magic/标志位在 [`ExchangeCodec.java`](https://github.com/apache/dubbo/blob/3.3/dubbo-remoting/dubbo-remoting-api/src/main/java/org/apache/dubbo/remoting/exchange/codec/ExchangeCodec.java)。可借鉴的是**所有权判断**,而不是照抄类名。 - **dubbo-go** 的 [`common/constant`](https://github.com/apache/dubbo-go/tree/main/common/constant) 是 Go 包,按 `key.go`、`default.go` 等文件组织,调用方以包名限定标识符;但也存在模块就近的常量,例如 [`cluster/metrics/constants.go`](https://github.com/apache/dubbo-go/blob/main/cluster/metrics/constants.go)。Go 同一包的多个文件共享包作用域;这不等同于要求 C# 建一个可包揽所有值的类。 - **C#** 的 `namespace` 能组织类型,却不能在命名空间中直接声明 `const`。因此选用 `namespace + 小型 internal static class + 按职责命名的文件`:例如 `DubboNet.Clients.RegistryClient.RegistryCategories.Consumers`。文件夹/命名空间表达模块边界,类表达值的语义集合;不为常量新增程序集,也不使用全局 `Constants.cs`、`global using static` 或仅为缩短调用而上提可见性。`public const` 还会带来跨程序集编译时内联的兼容性约束,本轮不新增公开常量 API。 ### 在 #20 中如何落地 | 归属 | 例子 | 处理原则 | | --- | --- | --- | | 共享注册语义 | `providers` / `consumers` 类别 | 确认 ZK 节点、注册 metadata、Nacos 服务名是否表达同一类别后,才允许放在注册模块的 `RegistryCategories`;不把路径分隔符放进去。 | | ZooKeeper 路径 | `/dubbo`、`/providers`、`/consumers/` | 留在 `ZooKeeperRegistryPaths`,由类别与斜杠组成具体路径;根路径规范化保持原样。 | | Nacos 命名 | `providers:` / `consumers:`、`DEFAULT_GROUP` | 冒号由 Nacos 服务名格式负责,group 是独立的配置/命名语境;不能把 ZK 路径当 Nacos group。 | | 注册字段与 URL 参数 | `category`、`interface`、`group` 等 | 先查写入方、读取方及 wire 契约;同名但不同格式的字段不因拼写相同而共用。 | | 协议字节/实现限额 | 帧标志位、Hessian2 tag、大小预算 | 协议字节归 #17;可调策略/保护阈值留在各自所有者,不纳入本次客户端常量层。 | **推进边界**:PR #22 继续只负责 ZooKeeper 路径,保持其已写明的“不包含 Nacos 命名和消费者 metadata 类别”。后续在 #20 下另用 Draft PR 核对并提取真正同义的注册类别,再逐个处理注册字段/Provider URL 等,不预先决定合并到一个 PR。每一步测试先行,用**独立的字符串期望**锁定实际路径、Nacos 名称和 metadata 输出;先确认语义和调用方,再替换裸字符串,保持公开 API 和网络行为不变。验证通过、审查范围明确后再转 Ready;#20 仍由多个 PR 共同推进,不通过其中一个 PR 自动关闭。 -- 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]
