Struct MemcachedBackend 

pub struct MemcachedBackend { /* private fields */ }

Memcached backend powered by rust-memcache.

Build with builder; the terminal connect is async and verifies the server is reachable (unlike RedisBackend’s lazy build-then-connect split).

Implementations

impl MemcachedBackend

pub fn builder() -> MemcachedBackendBuilder

Start building a MemcachedBackend.

pub async fn refresh_ttl( &self, key: &str, ttl: Option<Duration>, ) -> Result<bool, BackendError>

Refresh a key’s TTL via the memcached touch command.

Mirrors cachekit-py’s refresh_ttl: a bare method, not part of TtlInspectable — memcached cannot read TTLs, so the trait (which requires ttl()) cannot be implemented, and TTL-refresh-on-read features will not auto-engage on this backend in any SDK. None makes the entry permanent (py’s refresh_ttl(key, 0)); TTLs clamp to the 30-day ceiling like set.

Returns true if the key existed and its expiry was updated.

Trait Implementations

impl Backend for MemcachedBackend

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

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

Retrieve the raw bytes stored under key, or None if absent.

fn set<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, value: Vec<u8>, ttl: Option<Duration>, ) -> Pin<Box<dyn Future<Output = Result<(), BackendError>> + Send + 'async_trait>>

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

Store value under key, optionally expiring after ttl.

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

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

Remove key and return true if it existed.

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

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

Return true if key exists without fetching the value.

fn health<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<HealthStatus, BackendError>> + Send + 'async_trait>>

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

Return health/status information for this backend.

fn as_lockable(&self) -> Option<&dyn LockableBackend>

Expose this backend’s LockableBackend capability, if it has one.

fn attach_metrics(&self, _provider: MetricsProvider)

Receive the client’s live hit/miss statistics.

impl Debug for MemcachedBackend

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

Formats the value using the given formatter.