Struct MemcachedCache 

pub struct MemcachedCache { /* private fields */ }

Available on crate feature memcached only.

Memcached distributed cache

This is an alternative L2 (warm tier) cache backend, providing:

• Distributed caching across multiple instances
• Simple key-value storage (no persistence)
• LRU eviction policy
• High throughput for read-heavy workloads

Note: Unlike Redis, Memcached does not support:

• TTL introspection (cannot get remaining TTL)
• Persistence to disk
• Advanced data structures

Implementations

impl MemcachedCache

pub fn new() -> CacheResult<Self>

Create new Memcached cache

Configuration

Uses MEMCACHED_URL environment variable or defaults to memcache://127.0.0.1:11211

Errors

Returns an error if the Memcached client cannot be created.

pub fn get_server_stats( &self, ) -> CacheResult<Vec<(String, HashMap<String, String>)>>

Get cache statistics (from Memcached server)

Returns server statistics like hits, misses, uptime, etc. Each tuple contains (server_address, stats_map)

Errors

Returns an error if the stats cannot be retrieved.

Trait Implementations

impl CacheBackend for MemcachedCache

Implement CacheBackend trait for MemcachedCache

fn get<'a>(&'a self, key: &'a str) -> BoxFuture<'a, Option<Bytes>>

Get value from cache by key

fn set_with_ttl<'a>( &'a self, key: &'a str, value: Bytes, ttl: Duration, ) -> BoxFuture<'a, CacheResult<()>>

Set value in cache with time-to-live

fn remove<'a>(&'a self, key: &'a str) -> BoxFuture<'a, CacheResult<()>>

Remove value from cache

fn health_check(&self) -> BoxFuture<'_, bool>

Check if cache backend is healthy

fn name(&self) -> &'static str

Get the name of this cache backend

fn set<'a>( &'a self, key: &'a str, value: Bytes, ) -> BoxFuture<'a, CacheResult<()>>

Set value in cache with default TTL (5 minutes)

fn remove_pattern<'a>( &'a self, _pattern: &'a str, ) -> BoxFuture<'a, CacheResult<()>>

Remove keys matching a pattern

impl L2CacheBackend for MemcachedCache

fn get_with_ttl<'a>( &'a self, key: &'a str, ) -> BoxFuture<'a, Option<(Bytes, Option<Duration>)>>

Get value with its remaining TTL from L2 cache