Files
knowledge-governance/internal/releaseadapter/v071/gateway_backend.go
T
姚章浩 5eef13b615 feat(object-gateway): 统一对象写网关与不可变治理日志
方案A:所有对象写入经 loopback 网关,持久计划/grant/intent/逐版本 receipt 与
attempt→grant delivery 落在治理 PG;scope 由 provider+endpoint+bucket 决定,
同一物理桶只允许一个写域。版本 append 不等于 CAS,未锚定计划在首笔业务写前拒绝。

本提交只含网关与其适配层接线、协议文档;生产独占、凭据切换与桶设置未改动。
2026-11-01 11:35:05 +08:00

67 lines
2.2 KiB
Go

package v071
import (
"context"
"errors"
"knowledge-governance/internal/objectgateway"
)
// NewGatewayBackend is server-side only. Clients never receive this credentialed object.
func NewGatewayBackend(c S3ObjectStoreConfig) (objectgateway.Backend, error) {
if c.Provider == "oss" {
s, e := newOSSVersionStore(c)
if e != nil {
return nil, e
}
return ossGatewayBackend{s}, nil
}
if c.Provider != "s3" && c.Provider != "minio" {
return nil, errors.New("gateway_backend_provider_unsupported")
}
s, e := NewS3ObjectStore(c)
if e != nil {
return nil, e
}
return &objectgateway.S3Backend{Client: s.client, Bucket: s.bucket, MaxBytes: s.maxObjectBytes}, nil
}
type ossGatewayBackend struct{ s *ossVersionStore }
func toGateway(v objectObservation) objectgateway.Version {
return objectgateway.Version{ID: v.VersionID, Owner: v.Owner, SHA256: v.SHA256, Bytes: v.Bytes, ETag: v.ETag}
}
func fromGateway(v objectgateway.Version) objectObservation {
return objectObservation{Exists: true, VersionID: v.ID, Owner: v.Owner, SHA256: v.SHA256, Bytes: v.Bytes, ETag: v.ETag}
}
func (b ossGatewayBackend) Ready(ctx context.Context) error { return b.s.versioning(ctx) }
func (b ossGatewayBackend) Observe(ctx context.Context, key, id string) (objectgateway.Version, bool, error) {
v, e := b.s.observeVersion(ctx, key, id)
return toGateway(v), v.Exists, e
}
func (b ossGatewayBackend) Put(ctx context.Context, key string, body []byte, owner string) (objectgateway.Version, error) {
v, e := b.s.appendVersion(ctx, key, body, owner)
return toGateway(v), e
}
func (b ossGatewayBackend) Delete(ctx context.Context, key string, v objectgateway.Version) error {
return b.s.removeVersion(ctx, key, fromGateway(v))
}
func (b ossGatewayBackend) List(ctx context.Context, key string) ([]objectgateway.Version, error) {
listing, e := b.s.listExactVersions(ctx, key)
if e != nil {
return nil, e
}
if len(listing.DeleteMarkers) != 0 {
return nil, errors.New("gateway_backend_delete_marker_conflict")
}
var out []objectgateway.Version
for _, v := range listing.Versions {
o, e := b.s.observeVersion(ctx, key, v.VersionID)
if e != nil || !o.Exists {
return nil, errors.New("gateway_backend_listing_changed")
}
out = append(out, toGateway(o))
}
return out, nil
}