Struct ResponseCache 

pub struct ResponseCache { /* private fields */ }

Cache middleware, see the module documentation. Cloning gives another handle to the same cache.

Implementations

impl ResponseCache

pub fn new() -> Self

pub fn ttl(self, ttl: Duration) -> Self

Lifetime of responses that do not say otherwise (default 60 seconds)

pub fn stale_while_revalidate(self, window: Duration) -> Self

Serve an expired response for this long while one request refreshes it in the background (default off)

pub fn max_entries(self, max: usize) -> Self

Most cached responses (default 1000); the oldest go first

pub fn max_body(self, bytes: usize) -> Self

Largest body that is cached (default 1 MiB)

pub fn statuses<I: IntoIterator<Item = u16>>(self, statuses: I) -> Self

Status codes worth caching (default only 200)

pub fn vary_by<I, S>(self, headers: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Request headers that change the response (Accept-Language, …): each distinct value gets its own entry, and Vary is added to the response

pub fn per_user(self) -> Self

Cache requests that carry Authorization or Cookie too, with a separate entry per credential. Only for responses that depend on nothing but the credential itself.

pub fn invalidate_prefix(&self, prefix: &str)

Drop every cached response whose path starts with prefix

pub fn clear(&self)

Drop everything

pub fn len(&self) -> usize

Number of cached responses

pub fn is_empty(&self) -> bool

Trait Implementations

impl Clone for ResponseCache

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for ResponseCache

fn default() -> Self

Returns the “default value” for a type.

impl Middleware for ResponseCache

fn handle<'life0, 'async_trait>( &'life0 self, req: Request, next: Next, ) -> Pin<Box<dyn Future<Output = Result<Response>> + Send + 'async_trait>>

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