Struct SharedCacheConfigBuilder 

pub struct SharedCacheConfigBuilder<Req, K, Resp> { /* private fields */ }

Builder for configuring and constructing a shared cache layer.

Implementations

impl<Req, K, Resp> SharedCacheConfigBuilder<Req, K, Resp>

where K: Hash + Eq + Clone + Send + 'static, Resp: Clone + Send + 'static,

pub fn new() -> Self

Creates a new builder with default values.

pub fn max_size(self, size: usize) -> Self

Sets the maximum number of entries in the cache.

Default: 100

pub fn ttl(self, ttl: Duration) -> Self

Sets the time-to-live for cached entries.

If set, entries will expire after the specified duration. Default: None (no expiration)

pub fn eviction_policy(self, policy: EvictionPolicy) -> Self

Sets the eviction policy for the cache.

Determines which entry to evict when the cache reaches capacity.

Options

• EvictionPolicy::Lru - Least Recently Used (default)
• EvictionPolicy::Lfu - Least Frequently Used
• EvictionPolicy::Fifo - First In, First Out

Default: EvictionPolicy::Lru

pub fn key_extractor<F>(self, f: F) -> Self

where F: Fn(&Req) -> K + Send + Sync + 'static,

Sets the function that extracts a cache key from a request.

This function must be provided before building.

pub fn name(self, name: impl Into<String>) -> Self

Sets the name of this cache instance for observability.

Default: "<unnamed>"

pub fn on_hit<F>(self, f: F) -> Self

where F: Fn() + Send + Sync + 'static,

Registers a callback when a cache hit occurs.

pub fn on_miss<F>(self, f: F) -> Self

where F: Fn() + Send + Sync + 'static,

Registers a callback when a cache miss occurs.

pub fn on_eviction<F>(self, f: F) -> Self

where F: Fn() + Send + Sync + 'static,

Registers a callback when an entry is evicted from the cache.

pub fn build(self) -> Result<SharedCacheLayer<Req, K, Resp>, CacheBuildError>

Builds the shared cache layer.

Errors

Returns crate::CacheBuildError::MissingKeyExtractor if key_extractor was not set before calling build().

Trait Implementations

impl<Req, K, Resp> Default for SharedCacheConfigBuilder<Req, K, Resp>

where K: Hash + Eq + Clone + Send + 'static, Resp: Clone + Send + 'static,

fn default() -> Self

Returns the “default value” for a type.