Struct RiMemoryCache 

pub struct RiMemoryCache { /* 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 RiMemoryCache

pub fn new() -> Self

Creates a new in-memory cache instance.

Returns

A new RiMemoryCache instance

Trait Implementations

impl Default for RiMemoryCache

fn default() -> Self

Returns the “default value” for a type.

impl RiCache for RiMemoryCache

fn get<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, ) -> Pin<Box<dyn Future<Output = RiResult<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<RiCachedValue> 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 = RiResult<()>> + 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.

Security

This method validates:

• Key length (max 1 KB)
• Value length (max 10 MB)
• Entry count (max 100,000 entries)
• Key format (no control characters or null bytes)

Parameters

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

Returns

A RiResult<()> indicating success or failure

fn delete<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, ) -> Pin<Box<dyn Future<Output = RiResult<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 RiResult<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 = RiResult<()>> + Send + 'async_trait>>

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

Clears all entries from the cache.

Returns

A RiResult<()> indicating success or failure

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

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

Gets cache statistics.

Returns

A RiCacheStats struct containing cache statistics

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

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

Cleans up all expired entries from the cache.

Returns

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

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

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

Gets all keys from the cache.

Returns

A RiResult<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 = RiResult<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 = RiResult<()>> + 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 = RiResult<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 = RiResult<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 = RiResult<usize>> + Send + 'async_trait>>

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

Removes all keys matching a regex pattern.