cache

package

Go to main page

Versions in this module

v1

v1.4.0

Jul 13, 2026

Changes in this version

type CacheManager

+ func SwapDefaultCacheManager(m *CacheManager) *CacheManager

+ func (m *CacheManager) InitWithRedis(client *redis.Client)

type CacheService

+ func NewRedisCacheWithRedis(client *redis.Client) CacheService

v1.3.0

Jul 12, 2026

Changes in this version

+ var ErrInvalidLockRetryInterval = errors.New("锁重试/续期间隔必须大于 0")

+ var ErrInvalidLockTTL = errors.New("锁 TTL 必须大于等于 1ms")

+ var ErrLockFuncNil = errors.New("锁业务函数不能为空")

+ var ErrLockNotAcquired = errors.New("未获取到锁")

+ func Exists(ctx context.Context, key string) (bool, error)

+ func Get(ctx context.Context, key string, dest any) (bool, error)

v1.2.0

Jul 4, 2026

Changes in this version

+ var ErrLockUnexpectedResult = errors.New("锁脚本返回非预期结果")

type CacheManager

+ func GetDefaultCache() *CacheManager

v1.1.1

Jun 23, 2026

v1.1.0

Jun 23, 2026

Changes in this version

+ var DefaultCache = NewCacheManager()

+ func SetDefaultCacheManager(m *CacheManager)

+ type CacheManager struct

+ func NewCacheManager() *CacheManager

+ func (m *CacheManager) Get() CacheService

+ func (m *CacheManager) Init()

+ func (m *CacheManager) Set(svc CacheService)

v1.0.4

Jun 22, 2026

v1.0.3

Jun 22, 2026

Changes in this version

+ var ErrLockExpired = errors.New("锁已过期")

+ var ErrLockNotHeld = errors.New("锁未被当前客户端持有")

+ var ErrRedisNotReady = errors.New("Redis 未初始化")

+ func AutoInitKeyBuilder(opts ...KeyBuilderOption)

+ func Decr(ctx context.Context, key string) (int64, error)

+ func DeleteWithPrefix(ctx context.Context, key string, prefix string) error

+ func ExtendLock(ctx context.Context, token *LockToken, ttl time.Duration) error

+ func ForceUnlock(ctx context.Context, key string) error

+ func GetLockTTL(ctx context.Context, key string) (time.Duration, error)

+ func GetRaw(ctx context.Context, key string) (string, error)

+ func GetTTL(ctx context.Context, key string) (time.Duration, error)

+ func GetWithPrefix(ctx context.Context, key string, dest any, prefix string) bool

+ func Incr(ctx context.Context, key string) (int64, error)

+ func IncrBy(ctx context.Context, key string, value int64) (int64, error)

+ func Init()

+ func InitKeyBuilder(prefix string, opts ...KeyBuilderOption)

+ func IsLocked(ctx context.Context, key string) (bool, error)

+ func K(key string) string

+ func KCounter(key string) string

+ func KLock(key string) string

+ func KPerm(key string) string

+ func KSession(key string) string

+ func KTemp(key string) string

+ func Lock(ctx context.Context, key string, ttl time.Duration) (bool, error)

+ func LockWithPrefix(ctx context.Context, key string, ttl time.Duration, prefix string) (bool, error)

+ func SetExpire(ctx context.Context, key string, ttl time.Duration) (bool, error)

+ func SetRaw(ctx context.Context, key string, value string, ttl time.Duration) error

+ func SetWithPrefix(ctx context.Context, key string, value any, ttl time.Duration, prefix string) error

+ func Unlock(ctx context.Context, token *LockToken) error

+ func UnlockByKey(ctx context.Context, key string) error

+ func UnlockWithPrefix(ctx context.Context, key string, prefix string) error

+ func WithLock(ctx context.Context, key string, ttl time.Duration, fn func() error) error

+ func WithLockAutoExtend(ctx context.Context, key string, initialTTL time.Duration, ...) error

+ type CacheService interface

+ Delete func(ctx context.Context, key string) error

+ DeleteByPattern func(ctx context.Context, pattern string) error

+ Exists func(ctx context.Context, key string) bool

+ Get func(ctx context.Context, key string, dest any) bool

+ Set func(ctx context.Context, key string, value any, ttl time.Duration) error

+ func GetCache() CacheService

+ func NewRedisCache() CacheService

+ type KeyBuilder struct

+ func GetKeyBuilder() *KeyBuilder

+ func NewKeyBuilder(opts ...KeyBuilderOption) *KeyBuilder

+ func (kb *KeyBuilder) Build(key string) string

+ func (kb *KeyBuilder) BuildCounter(key string) string

+ func (kb *KeyBuilder) BuildLock(key string) string

+ func (kb *KeyBuilder) BuildPattern(pattern string) string

+ func (kb *KeyBuilder) BuildPerm(key string) string

+ func (kb *KeyBuilder) BuildSession(key string) string

+ func (kb *KeyBuilder) BuildTemp(key string) string

+ func (kb *KeyBuilder) GetPrefix() string

+ func (kb *KeyBuilder) SetPrefix(prefix string) *KeyBuilder

+ type KeyBuilderOption func(*KeyBuilder)

+ func WithCacheType(cacheType string) KeyBuilderOption

+ func WithPrefix(prefix string) KeyBuilderOption

+ func WithSeparator(separator string) KeyBuilderOption

+ type LockToken struct

+ Key string

+ Token string

+ func NewLock(ctx context.Context, key string, ttl time.Duration) (*LockToken, error)

+ func TryLock(ctx context.Context, key string, ttl time.Duration, ...) (*LockToken, error)

v1.0.1

Apr 30, 2026

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL