293 lines
8.8 KiB
Go
293 lines
8.8 KiB
Go
package global
|
|
|
|
import (
|
|
"context"
|
|
"io"
|
|
"log/slog"
|
|
"reflect"
|
|
"sync"
|
|
|
|
"github.com/redis/go-redis/v9"
|
|
"go.mongodb.org/mongo-driver/mongo"
|
|
"gorm.io/gorm"
|
|
platformmq "kra/pkg/mq"
|
|
platformws "kra/pkg/websocket"
|
|
)
|
|
|
|
// FileStorage is the transport-neutral subset shared by every file storage
|
|
// implementation. Domain operations that return business models remain in
|
|
// the biz-owned FileStorage interface instead of making global depend on biz.
|
|
type FileStorage interface {
|
|
Open(context.Context, string) (io.ReadCloser, error)
|
|
Delete(context.Context, string) error
|
|
DeletePrefix(context.Context, string) error
|
|
}
|
|
|
|
// Scheduler owns the lifecycle of the process-wide task scheduler. Scheduling
|
|
// business operations remain behind the task domain interfaces.
|
|
type Scheduler interface {
|
|
Start(context.Context) error
|
|
Stop(context.Context) error
|
|
}
|
|
|
|
// Resources is an immutable snapshot from the registry's point of view.
|
|
// Replacing a resource publishes a new snapshot; it does not close the old
|
|
// resource because lifecycle ownership belongs to the composition root.
|
|
type Resources struct {
|
|
Logger *slog.Logger
|
|
DB *gorm.DB
|
|
NamedDBs map[string]*gorm.DB
|
|
Redis redis.UniversalClient
|
|
NamedRedis map[string]redis.UniversalClient
|
|
Mongo *mongo.Client
|
|
Storage FileStorage
|
|
MQ platformmq.Registry
|
|
WebSocket platformws.Hub
|
|
Scheduler Scheduler
|
|
}
|
|
|
|
// ResourceRegistry provides concurrency-safe access to process-wide runtime
|
|
// resources. Prefer constructor injection for domain code; the registry is for
|
|
// framework callbacks and integration points that cannot be wired directly.
|
|
type ResourceRegistry struct {
|
|
mu sync.RWMutex
|
|
resources Resources
|
|
}
|
|
|
|
func NewResourceRegistry() *ResourceRegistry {
|
|
return &ResourceRegistry{resources: normalizeResources(Resources{})}
|
|
}
|
|
|
|
func (r *ResourceRegistry) Snapshot() Resources {
|
|
if r == nil {
|
|
return normalizeResources(Resources{})
|
|
}
|
|
r.mu.RLock()
|
|
resources := cloneResources(r.resources)
|
|
r.mu.RUnlock()
|
|
return resources
|
|
}
|
|
|
|
func (r *ResourceRegistry) Replace(resources Resources) {
|
|
if r == nil {
|
|
return
|
|
}
|
|
r.mu.Lock()
|
|
r.resources = normalizeResources(resources)
|
|
r.mu.Unlock()
|
|
}
|
|
|
|
func (r *ResourceRegistry) Logger() *slog.Logger { return r.Snapshot().Logger }
|
|
|
|
func (r *ResourceRegistry) SetLogger(logger *slog.Logger) {
|
|
r.update(func(resources *Resources) { resources.Logger = logger })
|
|
}
|
|
|
|
func (r *ResourceRegistry) DB() *gorm.DB { return r.Snapshot().DB }
|
|
|
|
func (r *ResourceRegistry) SetDB(db *gorm.DB) {
|
|
r.update(func(resources *Resources) { resources.DB = db })
|
|
}
|
|
|
|
// NamedDB returns a configured secondary database by alias. An empty alias
|
|
// resolves to the primary database.
|
|
func (r *ResourceRegistry) NamedDB(name string) *gorm.DB {
|
|
if name == "" {
|
|
return r.DB()
|
|
}
|
|
return r.Snapshot().NamedDBs[name]
|
|
}
|
|
|
|
// SetNamedDBs replaces the complete secondary-database alias set.
|
|
func (r *ResourceRegistry) SetNamedDBs(databases map[string]*gorm.DB) {
|
|
r.update(func(resources *Resources) { resources.NamedDBs = cloneDBMap(databases) })
|
|
}
|
|
|
|
func (r *ResourceRegistry) Redis() redis.UniversalClient { return r.Snapshot().Redis }
|
|
|
|
func (r *ResourceRegistry) SetRedis(client redis.UniversalClient) {
|
|
r.update(func(resources *Resources) { resources.Redis = client })
|
|
}
|
|
|
|
// NamedRedis returns a configured secondary Redis client by alias. An empty
|
|
// alias resolves to the primary Redis client.
|
|
func (r *ResourceRegistry) NamedRedis(name string) redis.UniversalClient {
|
|
if name == "" {
|
|
return r.Redis()
|
|
}
|
|
return r.Snapshot().NamedRedis[name]
|
|
}
|
|
|
|
// SetNamedRedis replaces the complete secondary-Redis alias set.
|
|
func (r *ResourceRegistry) SetNamedRedis(clients map[string]redis.UniversalClient) {
|
|
r.update(func(resources *Resources) { resources.NamedRedis = cloneRedisMap(clients) })
|
|
}
|
|
|
|
func (r *ResourceRegistry) Mongo() *mongo.Client { return r.Snapshot().Mongo }
|
|
|
|
func (r *ResourceRegistry) SetMongo(client *mongo.Client) {
|
|
r.update(func(resources *Resources) { resources.Mongo = client })
|
|
}
|
|
|
|
func (r *ResourceRegistry) Storage() FileStorage { return r.Snapshot().Storage }
|
|
|
|
func (r *ResourceRegistry) SetStorage(storage FileStorage) {
|
|
r.update(func(resources *Resources) { resources.Storage = storage })
|
|
}
|
|
|
|
func (r *ResourceRegistry) MQ() platformmq.Registry { return r.Snapshot().MQ }
|
|
|
|
func (r *ResourceRegistry) SetMQ(registry platformmq.Registry) {
|
|
r.update(func(resources *Resources) { resources.MQ = registry })
|
|
}
|
|
|
|
func (r *ResourceRegistry) WebSocket() platformws.Hub { return r.Snapshot().WebSocket }
|
|
|
|
func (r *ResourceRegistry) SetWebSocket(hub platformws.Hub) {
|
|
r.update(func(resources *Resources) { resources.WebSocket = hub })
|
|
}
|
|
|
|
func (r *ResourceRegistry) Scheduler() Scheduler { return r.Snapshot().Scheduler }
|
|
|
|
func (r *ResourceRegistry) SetScheduler(scheduler Scheduler) {
|
|
r.update(func(resources *Resources) { resources.Scheduler = scheduler })
|
|
}
|
|
|
|
func (r *ResourceRegistry) update(change func(*Resources)) {
|
|
if r == nil || change == nil {
|
|
return
|
|
}
|
|
r.mu.Lock()
|
|
resources := cloneResources(r.resources)
|
|
change(&resources)
|
|
r.resources = normalizeResources(resources)
|
|
r.mu.Unlock()
|
|
}
|
|
|
|
func normalizeResources(resources Resources) Resources {
|
|
if resources.Logger == nil {
|
|
resources.Logger = slog.Default()
|
|
}
|
|
resources.Redis = normalizeInterface(resources.Redis)
|
|
resources.Storage = normalizeInterface(resources.Storage)
|
|
resources.MQ = normalizeInterface(resources.MQ)
|
|
resources.WebSocket = normalizeInterface(resources.WebSocket)
|
|
resources.Scheduler = normalizeInterface(resources.Scheduler)
|
|
resources.NamedDBs = cloneDBMap(resources.NamedDBs)
|
|
resources.NamedRedis = cloneRedisMap(resources.NamedRedis)
|
|
return resources
|
|
}
|
|
|
|
func cloneResources(resources Resources) Resources {
|
|
resources.NamedDBs = cloneDBMap(resources.NamedDBs)
|
|
resources.NamedRedis = cloneRedisMap(resources.NamedRedis)
|
|
return resources
|
|
}
|
|
|
|
func cloneDBMap(source map[string]*gorm.DB) map[string]*gorm.DB {
|
|
if len(source) == 0 {
|
|
return nil
|
|
}
|
|
copyOf := make(map[string]*gorm.DB, len(source))
|
|
for name, db := range source {
|
|
if name != "" && db != nil {
|
|
copyOf[name] = db
|
|
}
|
|
}
|
|
if len(copyOf) == 0 {
|
|
return nil
|
|
}
|
|
return copyOf
|
|
}
|
|
|
|
func cloneRedisMap(source map[string]redis.UniversalClient) map[string]redis.UniversalClient {
|
|
if len(source) == 0 {
|
|
return nil
|
|
}
|
|
copyOf := make(map[string]redis.UniversalClient, len(source))
|
|
for name, client := range source {
|
|
if name == "" {
|
|
continue
|
|
}
|
|
client = normalizeInterface(client)
|
|
if client != nil {
|
|
copyOf[name] = client
|
|
}
|
|
}
|
|
if len(copyOf) == 0 {
|
|
return nil
|
|
}
|
|
return copyOf
|
|
}
|
|
|
|
func normalizeInterface[T any](value T) T {
|
|
reflected := reflect.ValueOf(value)
|
|
if reflected.IsValid() {
|
|
switch reflected.Kind() {
|
|
case reflect.Chan, reflect.Func, reflect.Interface, reflect.Map, reflect.Pointer, reflect.Slice:
|
|
if !reflected.IsNil() {
|
|
return value
|
|
}
|
|
default:
|
|
return value
|
|
}
|
|
}
|
|
var zero T
|
|
return zero
|
|
}
|
|
|
|
var defaultResources = NewResourceRegistry()
|
|
|
|
// Install publishes resources assembled by the composition root and returns
|
|
// the process-wide registry for lifecycle wiring.
|
|
func Install(resources Resources) *ResourceRegistry {
|
|
defaultResources.Replace(resources)
|
|
return defaultResources
|
|
}
|
|
|
|
func DefaultRegistry() *ResourceRegistry { return defaultResources }
|
|
|
|
func ResourceSnapshot() Resources { return defaultResources.Snapshot() }
|
|
|
|
func ReplaceResources(resources Resources) { defaultResources.Replace(resources) }
|
|
|
|
func Logger() *slog.Logger { return defaultResources.Logger() }
|
|
|
|
func SetLogger(logger *slog.Logger) { defaultResources.SetLogger(logger) }
|
|
|
|
func DB() *gorm.DB { return defaultResources.DB() }
|
|
|
|
func SetDB(db *gorm.DB) { defaultResources.SetDB(db) }
|
|
|
|
func NamedDB(name string) *gorm.DB { return defaultResources.NamedDB(name) }
|
|
|
|
func SetNamedDBs(databases map[string]*gorm.DB) { defaultResources.SetNamedDBs(databases) }
|
|
|
|
func Redis() redis.UniversalClient { return defaultResources.Redis() }
|
|
|
|
func SetRedis(client redis.UniversalClient) { defaultResources.SetRedis(client) }
|
|
|
|
func NamedRedis(name string) redis.UniversalClient { return defaultResources.NamedRedis(name) }
|
|
|
|
func SetNamedRedis(clients map[string]redis.UniversalClient) { defaultResources.SetNamedRedis(clients) }
|
|
|
|
func Mongo() *mongo.Client { return defaultResources.Mongo() }
|
|
|
|
func SetMongo(client *mongo.Client) { defaultResources.SetMongo(client) }
|
|
|
|
func Storage() FileStorage { return defaultResources.Storage() }
|
|
|
|
func SetStorage(storage FileStorage) { defaultResources.SetStorage(storage) }
|
|
|
|
func MQ() platformmq.Registry { return defaultResources.MQ() }
|
|
|
|
func SetMQ(registry platformmq.Registry) { defaultResources.SetMQ(registry) }
|
|
|
|
func WebSocket() platformws.Hub { return defaultResources.WebSocket() }
|
|
|
|
func SetWebSocket(hub platformws.Hub) { defaultResources.SetWebSocket(hub) }
|
|
|
|
func TaskScheduler() Scheduler { return defaultResources.Scheduler() }
|
|
|
|
func SetTaskScheduler(scheduler Scheduler) { defaultResources.SetScheduler(scheduler) }
|