Struct SmartCache 

pub struct SmartCache<V: CacheValue> { /* private fields */ }

Size-aware LRU cache with automatic cleanup.

Uses DashMap for lock-free concurrent reads. Writes are per-shard and do not block readers on other shards.

Implementations

impl<V: CacheValue> SmartCache<V>

pub fn new() -> Self

Create a new cache with default settings.

Default: 1000 entries, 50MB max size, 5 minute TTL.

pub fn with_limits( max_entries: usize, max_size_bytes: usize, default_ttl: Duration, ) -> Self

Create with custom limits.

pub fn small() -> Self

Create a small cache (100 entries, 5MB).

pub fn large() -> Self

Create a large cache (10000 entries, 200MB).

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

Get a value from the cache.

pub async fn set(&self, key: impl Into<String>, value: V)

Set a value in the cache.

pub async fn set_with_ttl( &self, key: impl Into<String>, value: V, ttl: Duration, )

Set a value with custom TTL.

pub async fn remove(&self, key: &str) -> Option<V>

Remove a value from the cache.

pub async fn clear(&self)

Clear the entire cache.

pub async fn len(&self) -> usize

Get current entry count.

pub async fn is_empty(&self) -> bool

Check if cache is empty.

pub fn size_bytes(&self) -> usize

Get current size in bytes.

pub fn stats(&self) -> &CacheStats

Get cache statistics.

pub async fn cleanup_expired(&self)

Clean up expired entries.

pub fn start_cleanup_task(self: Arc<Self>, interval: Duration) -> JoinHandle<()>

Start a background cleanup task.

Runs cleanup every interval duration.

Trait Implementations

impl<V: Debug + CacheValue> Debug for SmartCache<V>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<V: CacheValue> Default for SmartCache<V>

fn default() -> Self

Returns the “default value” for a type.