Struct ServiceAdapter 

pub struct ServiceAdapter<K, V, S> { /* private fields */ }

Available on crate feature service only.

Adapter that converts a Service<CacheOperation> into a CacheTier.

This enables using service-based cache implementations (like Redis or Memcached) as storage backends for Cache. The service can be composed with middleware (retry, timeout, circuit breakers) before being wrapped by this adapter.

Examples

// Convert any Service<CacheOperation> to a CacheTier
let adapter = ServiceAdapter::new(redis_service);

// Use as cache storage
let cache = Cache::builder(clock)
    .storage(adapter)
    .build();

Implementations

impl<K, V, S> ServiceAdapter<K, V, S>

pub fn new(service: S) -> ServiceAdapter<K, V, S>

Creates a new ServiceAdapter wrapping the given service.

The service must implement Service<CacheOperation<K, V>> with output type Result<CacheResponse<V>, Error>.

pub fn inner(&self) -> &S

Returns a reference to the inner service.

Trait Implementations

impl<K, V, S> CacheTier<K, V> for ServiceAdapter<K, V, S>

where K: Clone + Eq + Hash + Send + Sync + 'static, V: Clone + Send + Sync + 'static, S: Service<CacheOperation<K, V>, Out = Result<CacheResponse<V>, Error>> + Send + Sync,

async fn get(&self, key: &K) -> Result<Option<CacheEntry<V>>, Error>

Gets a value, returning an error if the operation fails.

async fn insert(&self, key: K, entry: CacheEntry<V>) -> Result<(), Error>

Inserts or replaces a value, returning an error if the operation fails.

async fn invalidate(&self, key: &K) -> Result<(), Error>

Invalidates a value, returning an error if the operation fails.

async fn clear(&self) -> Result<(), Error>

Clears all entries, returning an error if the operation fails.

async fn len(&self) -> Result<u64, SizeError>

Returns an approximate count of entries, if the implementation supports it.

fn is_empty(&self) -> impl Future<Output = Result<bool, SizeError>> + Send

Returns Ok(true) if the cache appears to contain no entries.

impl<K, V, S> Clone for ServiceAdapter<K, V, S>

where K: Clone, V: Clone, S: Clone,

fn clone(&self) -> ServiceAdapter<K, V, S>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<K, V, S> Debug for ServiceAdapter<K, V, S>

where K: Debug, V: Debug, S: Debug,

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

Formats the value using the given formatter.