Struct CacheResponse 

pub struct CacheResponse<R> {
    pub responder: R,
    pub cache_control: Option<CacheControl>,
}

Available on crate feature cache only.

The responder with a Cache-Control header.

Fields

responder: R

The responder that produces the response itself.

cache_control: Option<CacheControl>

The directives to send. None adds no Cache-Control header at all.

Implementations

impl<R> CacheResponse<R>

pub fn new( responder: R, cache_control: impl Into<Option<CacheControl>>, ) -> CacheResponse<R>

Attach the given directives to a responder. Passing None adds no Cache-Control header at all.

pub fn public(responder: R, max_age: u32) -> CacheResponse<R>

public, max-age=<max_age>: every cache, shared ones included, may reuse the response for max_age seconds.

pub fn private(responder: R, max_age: u32) -> CacheResponse<R>

private, max-age=<max_age>: only the browser that made the request may reuse the response, for max_age seconds.

pub fn no_cache(responder: R) -> CacheResponse<R>

no-cache: a cache may store the response, but it must ask the origin server whether the stored copy is still good before every reuse.

pub fn no_store(responder: R) -> CacheResponse<R>

no-store: no cache may store the response at all.

pub fn immutable(responder: R) -> CacheResponse<R>

public, max-age=31536000, immutable: the response never changes, so it should be reused for a year without any revalidation.

pub fn only_release(self) -> CacheResponse<R>

Drop the Cache-Control header when this program is built in the debug mode, so a browser always fetches the newest response during development.

Trait Implementations

impl<R> Clone for CacheResponse<R>

where R: Clone,

fn clone(&self) -> CacheResponse<R>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<R> Debug for CacheResponse<R>

where R: Debug,

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

Formats the value using the given formatter.

impl<'r, 'o, R> Responder<'r, 'o> for CacheResponse<R>

where 'o: 'r, R: Responder<'r, 'o>,

fn respond_to(self, request: &'r Request<'_>) -> Result<Response<'o>, Status>

Returns Ok if a Response could be generated successfully. Otherwise, returns an Err with a failing Status.