Struct AdaptiveCache 

pub struct AdaptiveCache<V: Clone + Send + Sync + 'static> { /* private fields */ }

Adaptive LRU cache with intelligent TTL adjustment

This cache monitors access patterns and adjusts TTL dynamically:

• Frequently accessed items get longer TTL
• Rarely accessed items get shorter TTL
• Reduces memory waste on cold items
• Improves hit rate for hot items

Thread Safety

This cache is designed for single-threaded async access. All public methods acquire the write lock internally. For higher concurrency, consider using fine-grained locking strategies.

Implementations

impl<V: Clone + Send + Sync + 'static> AdaptiveCache<V>

pub fn new(config: AdaptiveCacheConfig) -> Self

Create a new adaptive cache with default configuration

pub async fn record_access(&self, id: Uuid, hit: bool, value: Option<V>) -> bool

Record a cache access (hit or miss)

Arguments

• id - Unique identifier for the cache entry
• hit - Whether this was a cache hit (true) or miss (false)
• value - Value to store (only used on cache miss)

Returns

true if the entry was found and is valid, false otherwise

pub async fn get(&self, id: Uuid) -> Option<V>

Get the current value for an entry without recording access

pub async fn get_and_record(&self, id: Uuid) -> Option<V>

Get the current value and record access

pub async fn remove(&self, id: Uuid)

Remove an entry from the cache

pub async fn contains(&self, id: Uuid) -> bool

Check if an entry exists and is not expired

pub async fn access_count(&self, id: Uuid) -> Option<usize>

Get access count for an entry

pub async fn ttl(&self, id: Uuid) -> Option<Duration>

Get current TTL for an entry

pub async fn get_metrics(&self) -> AdaptiveCacheMetrics

Get current cache metrics

pub async fn clear(&self)

Clear all entries from cache

pub async fn cleanup_expired(&self) -> usize

Manually cleanup expired entries

pub async fn hot_count(&self) -> usize

Get the number of hot items

pub async fn cold_count(&self) -> usize

Get the number of cold items

pub async fn len(&self) -> usize

Get cache size (number of entries)

pub async fn is_empty(&self) -> bool

Check if cache is empty

pub fn stop_cleanup(&mut self)

Stop the background cleanup task

Trait Implementations

impl<V: Clone + Send + Sync + 'static> Drop for AdaptiveCache<V>

fn drop(&mut self)

Executes the destructor for this type.