keyvalues

type BinaryEntry interface {
	Entry

	Put(value []byte, opt *Options) error

	Get() ([]byte, error)
}

type Class interface {
	Name() ClassName

	Alias() ClassAlias

	Namespace() Namespace

	GetTextEntry(id string) TextEntry

	GetBinaryEntry(id string) BinaryEntry

	GetJSONEntry(id string) JSONEntry
}

type ClassAlias string

type ClassGetter interface {
	GetClass(name ClassName) (Class, error)
}

type ClassInfo struct {
	ID string // 在 properties 中的 ID

	Namespace  NS         // refer to NS.name
	Store      string     // refer to Store.name
	SimpleName SimpleName // simple name of this class
	MaxAge     time.Duration
	Enabled    bool

	Class  Class
	Loader ClassLoader
}

type ClassLoader interface {
	LoadClass(name ClassName) (Class, error)
}

type ClassName string

type Configuration struct {
	Name          string // name of this config
	Driver        string
	Host          string
	Port          int
	Username      string
	Password      string
	DefaultMaxAge time.Duration
	Enabled       bool
}

type Driver interface {
	Open(cfg *Configuration) (Store, error)
}

type DriverGetter interface {
	GetDriver(name string) (Driver, error)
}

type DriverInfo struct {
	Name   string
	Driver Driver
}

type Entry interface {
	Class() Class

	Key() string
}

type JSONEntry interface {
	Entry

	Put(value any, opt *Options) error

	Get(value any) error
}

type NS string

type Namespace interface {
	Name() NS

	GetClass(alias ClassAlias) (Class, error)
}

type NamespaceGetter interface {
	GetNamespace(ns NS) (Namespace, error)
}

type NamespaceInfo struct {
	Name      NS
	Namespace Namespace
}

type NamespaceLoader interface {
	LoadNamespace(ns NS) (Namespace, error)
}

type Options struct {
	MaxAge time.Duration
}

type Registration struct {
	Enabled  bool
	Priority int

	Driver *DriverInfo
}

type Registry interface {
	ListRegistrations() []*Registration
}

type Service interface {
	GetClassNS(ns NS, alias ClassAlias) (Class, error)

	ClassGetter
	DriverGetter
	NamespaceGetter
	StoreGetter
}

type SimpleName = ClassAlias

type Store interface {
	Put(key string, value []byte, opt *Options) error
	Get(key string) ([]byte, error)
	Contains(key string) (bool, error)
}

type StoreGetter interface {
	GetStore(name string) (Store, error)
}

type StoreInfo struct {
	Enabled bool
	Name    string

	Host     string
	Port     int
	Username string
	Password string
	Driver   string
	MaxAge   time.Duration

	Store Store
}

type StoreLoader interface {
	LoadStore(name string) (Store, error)
}

type TextEntry interface {
	Entry

	Put(value string, opt *Options) error

	Get() (string, error)
}

type Want struct {
	Namespace string
	Class     SimpleName
	ID        string
}