Constitution compliance: add native-client escape hatch
还没有人认领这个 Issue。
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 45/100
- Issue 类型
- 功能
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- java
调研方向
先从公开的 MulticloudDbClient 契约和 issue #38 中的当前状态表开始，然后检查三个 provider adapter，了解其现有 client 和生命周期边界。在为 Cosmos、DynamoDB 和 Spanner 实现共享的 escape-hatch 契约之前，先定义该契约以及对不支持类型的行为。共享契约测试、provider 专用测试以及更新后的 API 和架构文档满足每项验收标准后，即视为完成。
由索引模型根据 Issue 内容生成。
描述
Problem
The constitution requires every provider adapter to expose an explicit native-client escape hatch. The current public MulticloudDbClient contract states that no code-level escape hatch exists, and the repository contains no nativeClient(...) implementation. Issue #38 currently lists this capability as already available, so the implementation and supportability inventory disagree.
Scope
- Design a type-safe, explicit opt-in boundary for obtaining the underlying Cosmos, DynamoDB, or Spanner client.
- Define ownership, lifecycle, logging, and unsupported-type behavior.
- Implement the contract for all three providers without changing portable default behavior.
- Correct the current-state table in #38 and update API/architecture documentation.
Acceptance criteria
- All three adapters expose their native client through one documented public escape-hatch contract.
- Incorrect requested native types fail predictably without unsafe casts.
- Native access does not weaken configuration-only portable behavior or client lifecycle safety.
- Shared contract tests and provider-specific tests cover the boundary.
- 主要语言
- Java
- 星标
- 7
- 派生
- 7
- 平均合并
- 1 天 19 小时
- 30 天内合并 PR
- 3
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
microsoft/multiclouddb-sdk-for-java 的其他 Issue
-
Portable document key fields differ across Cosmos/Dynamo and read/query (id vs sortKey)可能已有人在做 @allenkim0129 于 16 天前认领。 未关闭
microsoft/multiclouddb-sdk-for-java#121 · 已指派 1 人 ·
-
难度 5/5 一周以上 新手友好度 25/100
-
难度 5/5 一周以上 新手友好度 35/100
-
难度 5/5 一周以上 新手友好度 25/100
-
难度 5/5 一周以上 新手友好度 28/100
查看 microsoft/multiclouddb-sdk-for-java 的全部 Issue
相似的 Issue
-
approved
难度 2/5 1-3 小时 新手友好度 67/100
checkstyle/checkstyle#22129 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 78/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 80/100
objectionary/lints#1577 ·
维护者通常 2 天内回复
-
ChaosEngine: backup-remote doctor row passes while consumer mode hides bot memory from git可能已有人在做 @MohabMohie 今天认领。 未关闭agentic
难度 2/5 1-3 小时 新手友好度 76/100
ShaftHQ/SHAFT_ENGINE#7263 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 82/100