mirror of
https://github.com/lukaszraczylo/traefikoidc.git
synced 2026-06-06 22:49:43 +00:00
lukaszraczylo
6efb78b7a8
* Smarter approach to the cookies - Single maxCookieSize = 1400 constant with clear documentation - Combined cookie storage for ~40-45% size reduction - Backward compatible migration from legacy cookies * Tuneup the code.
103 lines
3.1 KiB
Go
103 lines
3.1 KiB
Go
// Package backend provides cache backend implementations for the Traefik OIDC plugin.
|
|
package backends
|
|
|
|
import (
|
|
"context"
|
|
"time"
|
|
)
|
|
|
|
// CacheBackend defines the interface for all cache backend implementations
|
|
// Implementations include: MemoryBackend, RedisBackend, and HybridBackend
|
|
type CacheBackend interface {
|
|
// Set stores a value in the cache with the specified TTL
|
|
// Returns an error if the operation fails
|
|
Set(ctx context.Context, key string, value []byte, ttl time.Duration) error
|
|
|
|
// Get retrieves a value from the cache
|
|
// Returns: value, remaining TTL, exists flag, and error
|
|
// If the key doesn't exist, exists will be false
|
|
Get(ctx context.Context, key string) (value []byte, ttl time.Duration, exists bool, err error)
|
|
|
|
// Delete removes a key from the cache
|
|
// Returns true if the key was deleted, false if it didn't exist
|
|
Delete(ctx context.Context, key string) (bool, error)
|
|
|
|
// Exists checks if a key exists in the cache
|
|
Exists(ctx context.Context, key string) (bool, error)
|
|
|
|
// Clear removes all keys from the cache
|
|
Clear(ctx context.Context) error
|
|
|
|
// GetStats returns cache statistics
|
|
// Stats include: hits, misses, size, memory usage, etc.
|
|
GetStats() map[string]interface{}
|
|
|
|
// Close shuts down the cache backend and releases resources
|
|
Close() error
|
|
|
|
// Ping checks if the backend is healthy and responsive
|
|
Ping(ctx context.Context) error
|
|
}
|
|
|
|
// BackendStats represents statistics for a cache backend
|
|
type BackendStats struct {
|
|
StartTime time.Time
|
|
LastErrorTime time.Time
|
|
Type BackendType
|
|
LastError string
|
|
Deletes int64
|
|
Errors int64
|
|
Evictions int64
|
|
CurrentSize int64
|
|
MaxSize int64
|
|
MemoryUsage int64
|
|
AverageGetLatency time.Duration
|
|
AverageSetLatency time.Duration
|
|
Sets int64
|
|
Misses int64
|
|
Uptime time.Duration
|
|
Hits int64
|
|
}
|
|
|
|
// BackendCapabilities describes the capabilities of a cache backend
|
|
type BackendCapabilities struct {
|
|
// Distributed indicates if the backend is distributed across multiple instances
|
|
Distributed bool
|
|
|
|
// Persistent indicates if the backend persists data across restarts
|
|
Persistent bool
|
|
|
|
// Eviction indicates if the backend supports automatic eviction
|
|
Eviction bool
|
|
|
|
// TTL indicates if the backend supports TTL (time-to-live)
|
|
TTL bool
|
|
|
|
// MaxKeySize is the maximum size of a key in bytes (0 = unlimited)
|
|
MaxKeySize int64
|
|
|
|
// MaxValueSize is the maximum size of a value in bytes (0 = unlimited)
|
|
MaxValueSize int64
|
|
|
|
// MaxKeys is the maximum number of keys (0 = unlimited)
|
|
MaxKeys int64
|
|
|
|
// SupportsExpire indicates if the backend supports expiration
|
|
SupportsExpire bool
|
|
|
|
// SupportsMultiGet indicates if the backend supports batch get operations
|
|
SupportsMultiGet bool
|
|
|
|
// SupportsTransaction indicates if the backend supports transactions
|
|
SupportsTransaction bool
|
|
|
|
// SupportsCompression indicates if the backend supports compression
|
|
SupportsCompression bool
|
|
|
|
// RequiresSerialize indicates if values must be serialized
|
|
RequiresSerialize bool
|
|
|
|
// AtomicOperations indicates if the backend supports atomic operations
|
|
AtomicOperations bool
|
|
}
|