Struct CacheLayer

pub struct CacheLayer<C> { /* private fields */ }

The main struct of the library. The layer providing caching to the wrapped service.

Implementations

impl<C> CacheLayer<C>

where C: Cached<(Method, Uri), CachedResponse> + CloneCached<(Method, Uri), CachedResponse>,

pub fn with(cache: C) -> Self

Create a new cache layer with a given cache and the default body size limit of 128 MB.

pub fn use_stale_on_failure(self) -> Self

Switch the layer’s settings to preserve the last successful response even when it’s evicted from the cache but the service failed to provide a new successful response (ie. eg. when the underlying service responds with 404 NOT FOUND, the cache will keep providing the last stale 200 OK response produced).

pub fn body_limit(self, new_limit: usize) -> Self

Change the maximum body size limit. If you want unlimited size, use usize::MAX.

pub fn allow_invalidation(self) -> Self

Allow manual cache invalidation by setting the X-Invalidate-Cache header in the request. This will allow the cache to be invalidated for the given key.

pub fn add_response_headers(self) -> Self

Allow the response headers to be included in the cached response.

impl CacheLayer<TimedCache<(Method, Uri), CachedResponse>>

pub fn with_lifespan( ttl_sec: u64, ) -> CacheLayer<TimedCache<(Method, Uri), CachedResponse>>

Create a new cache layer with the desired TTL in seconds

Trait Implementations

impl<C: Clone> Clone for CacheLayer<C>

fn clone(&self) -> CacheLayer<C>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<S, C> Layer<S> for CacheLayer<C>

type Service = CacheService<S, C>

The wrapped service

fn layer(&self, inner: S) -> Self::Service

Wrap the given service with the middleware, returning a new service that has been decorated with the middleware.