Constitution compliance: add native-client escape hatch
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 45/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Khá rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- java
- Lĩnh vực
- backend-api-design, databases, documentation
Hướng nghiên cứu
Bắt đầu với contract công khai của MulticloudDbClient và bảng trạng thái hiện tại trong issue #38, sau đó kiểm tra ba provider adapter để xác định ranh giới hiện có của client và lifecycle của chúng. Xác định contract escape-hatch dùng chung và hành vi của nó đối với các kiểu không được hỗ trợ trước khi triển khai cho Cosmos, DynamoDB và Spanner. Công việc được xem là hoàn tất khi các contract test dùng chung, các test dành riêng cho từng provider và tài liệu API và kiến trúc đã cập nhật đều đáp ứng mọi tiêu chí chấp nhận.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
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.
- Ngôn ngữ chính
- Java
- Star
- 7
- Fork
- 7
- Merge trung bình
- 1 ngày 19 giờ
- Pull request đã merge (30 ngày)
- 3
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của microsoft/multiclouddb-sdk-for-java
-
Portable document key fields differ across Cosmos/Dynamo and read/query (id vs sortKey)Có thể đã có người làm @allenkim0129 đã nhận 15 ngày trước. Đang mở
microsoft/multiclouddb-sdk-for-java#121 · 1 người được giao ·
-
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 25/100
-
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 35/100
-
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 25/100
-
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 28/100
Tất cả issue của microsoft/multiclouddb-sdk-for-java
Issue tương tự
-
enhancement web-ui
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 67/100
jenkinsci/jenkins#27583 · 2 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
apache/rocketmq-dashboard#7302 ·
Maintainer thường phản hồi trong vòng 3 ngày
-
area: android good first issue help wanted testing
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
Gautam-aman/ResQNet#56 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
documentation hermes-queue
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
chrisalunlloyd2-sudo/mindpalace#294 ·
Maintainer thường phản hồi trong vòng 1 ngày