Struct Cache

pub struct Cache<B: CacheBackend> { /* private fields */ }

High-level cache interface with type-safe operations

Implementations

impl<B: CacheBackend> Cache<B>

pub fn new(backend: B) -> Self

Create a new cache instance with the given backend

pub fn with_default_ttl(backend: B, ttl: Duration) -> Self

Create a new cache instance with a default TTL

pub async fn get<T>(&self, key: &str) -> CacheResult<Option<T>>

where T: DeserializeOwned,

Get a typed value from the cache

pub async fn put<T>( &self, key: &str, value: &T, ttl: Duration, ) -> CacheResult<()>

where T: Serialize,

Put a typed value in the cache

pub async fn put_default<T>(&self, key: &str, value: &T) -> CacheResult<()>

where T: Serialize,

Put a typed value in the cache using default TTL

pub async fn forget(&self, key: &str) -> CacheResult<bool>

Remove a value from the cache

pub async fn exists(&self, key: &str) -> CacheResult<bool>

Check if a key exists

pub async fn flush(&self) -> CacheResult<()>

Clear all cache entries

pub async fn remember<T, F, Fut>( &self, key: &str, ttl: Duration, compute: F, ) -> CacheResult<T>

where T: Serialize + DeserializeOwned, F: FnOnce() -> Fut, Fut: Future<Output = T>,

Remember pattern: get from cache or compute and store

pub async fn remember_default<T, F, Fut>( &self, key: &str, compute: F, ) -> CacheResult<T>

where T: Serialize + DeserializeOwned, F: FnOnce() -> Fut, Fut: Future<Output = T>,

Remember pattern with default TTL

pub async fn stats(&self) -> CacheResult<CacheStats>

Get cache statistics