Struct DMSCMemoryCache 

pub struct DMSCMemoryCache { /* private fields */ }

In-memory cache implementation using DashMap for high performance In-memory cache implementation using DashMap for high performance and thread safety.

This struct provides an in-memory cache with automatic expiration handling, comprehensive statistics, and thread-safe concurrent access.

Implementations

impl DMSCMemoryCache

pub fn new() -> Self

Creates a new in-memory cache instance.

Returns

A new DMSCMemoryCache instance

Trait Implementations

impl DMSCCache for DMSCMemoryCache

fn get<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, ) -> Pin<Box<dyn Future<Output = DMSCResult<Option<String>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Gets a value from the cache by key.

This method checks if the value exists and is not expired. If the value is expired, it is removed from the cache and None is returned. Otherwise, the value is returned and its last access time is updated.

Parameters

• key: The key to retrieve

Returns

An Option<DMSCCachedValue> containing the value if it exists and is not expired, or None otherwise

fn set<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, key: &'life1 str, value: &'life2 str, ttl_seconds: Option<u64>, ) -> Pin<Box<dyn Future<Output = DMSCResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Sets a value in the cache with the given key.

Parameters

• key: The key to set
• value: The cached value to store

Returns

A DMSCResult<()> indicating success or failure

fn delete<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, ) -> Pin<Box<dyn Future<Output = DMSCResult<bool>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Deletes a value from the cache by key.

Parameters

• key: The key to delete

Returns

A DMSCResult<bool> indicating whether the key was found and deleted

fn exists<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, ) -> Pin<Box<dyn Future<Output = bool> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Checks if a key exists in the cache and is not expired.

If the key exists but the value is expired, it is removed from the cache and false is returned.

Parameters

• key: The key to check

Returns

true if the key exists and is not expired, false otherwise

fn clear<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = DMSCResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Clears all entries from the cache.

Returns

A DMSCResult<()> indicating success or failure

fn stats<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = DMSCCacheStats> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Gets cache statistics.

Returns

A DMSCCacheStats struct containing cache statistics

fn cleanup_expired<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = DMSCResult<usize>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Cleans up all expired entries from the cache.

Returns

A DMSCResult<usize> containing the number of expired entries cleaned up

fn keys<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = DMSCResult<Vec<String>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Gets all keys from the cache.

Returns

A DMSCResult<Vec<String>> containing all cache keys

fn get_multi<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, keys: &'life1 [&'life2 str], ) -> Pin<Box<dyn Future<Output = DMSCResult<Vec<Option<String>>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Retrieves multiple values from the cache in a single operation.

fn set_multi<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, items: &'life1 [(&'life2 str, &'life3 str)], ttl_seconds: Option<u64>, ) -> Pin<Box<dyn Future<Output = DMSCResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Stores multiple key-value pairs in the cache.

fn delete_multi<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, keys: &'life1 [&'life2 str], ) -> Pin<Box<dyn Future<Output = DMSCResult<usize>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Removes multiple keys from the cache.

fn exists_multi<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, keys: &'life1 [&'life2 str], ) -> Pin<Box<dyn Future<Output = DMSCResult<Vec<bool>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Checks if multiple keys exist in the cache.

fn delete_by_pattern<'life0, 'life1, 'async_trait>( &'life0 self, pattern: &'life1 str, ) -> Pin<Box<dyn Future<Output = DMSCResult<usize>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Removes all keys matching a regex pattern.

impl Default for DMSCMemoryCache

fn default() -> Self

Returns the “default value” for a type.