Struct headers_ext::CacheControl

pub struct CacheControl { /* fields omitted */ }

Cache-Control header, defined in RFC7234

The Cache-Control header field is used to specify directives for caches along the request/response chain. Such cache directives are unidirectional in that the presence of a directive in a request does not imply that the same directive is to be given in the response.

ABNF

Cache-Control   = 1#cache-directive
cache-directive = token [ "=" ( token / quoted-string ) ]

Example values

• no-cache
• private, community="UCI"
• max-age=30

Example

use headers::CacheControl;

let cc = CacheControl::new();

Methods

impl CacheControl

pub fn new() -> Self

Construct a new empty CacheControl header.

pub fn no_cache(&self) -> bool

Check if the no-cache directive is set.

pub fn no_store(&self) -> bool

Check if the no-store directive is set.

pub fn no_transform(&self) -> bool

Check if the no-transform directive is set.

pub fn only_if_cached(&self) -> bool

Check if the only-if-cached directive is set.

pub fn public(&self) -> bool

Check if the public directive is set.

pub fn private(&self) -> bool

Check if the private directive is set.

pub fn max_age(&self) -> Option<Duration>

Get the value of the max-age directive if set.

pub fn max_stale(&self) -> Option<Duration>

Get the value of the max-stale directive if set.

pub fn min_fresh(&self) -> Option<Duration>

Get the value of the min-fresh directive if set.

pub fn s_max_age(&self) -> Option<Duration>

Get the value of the s-maxage directive if set.

pub fn with_no_cache(self) -> Self

Set the no-cache directive.

pub fn with_no_store(self) -> Self

Set the no-store directive.

pub fn with_no_transform(self) -> Self

Set the no-transform directive.

pub fn with_only_if_cached(self) -> Self

Set the only-if-cached directive.

pub fn with_private(self) -> Self

Set the private directive.

pub fn with_public(self) -> Self

Set the public directive.

pub fn with_max_age(self, seconds: Duration) -> Self

Set the max-age directive.

pub fn with_max_stale(self, seconds: Duration) -> Self

Set the max-stale directive.

pub fn with_min_fresh(self, seconds: Duration) -> Self

Set the min-fresh directive.

pub fn with_s_max_age(self, seconds: Duration) -> Self

Set the s-maxage directive.

Trait Implementations

impl PartialEq for CacheControl

fn eq(&self, other: &CacheControl) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &CacheControl) -> bool

This method tests for !=.

impl Clone for CacheControl

fn clone(&self) -> CacheControl

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CacheControl

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

Formats the value using the given formatter.

impl Header for CacheControl

const NAME: &'static HeaderName

NAME: &'static HeaderName = &::http::header::CACHE_CONTROL

The name of this header.

fn decode(values: &mut Values) -> Option<Self>

Decode this type from a HeaderValue.

fn encode(&self, values: &mut ToValues)

Encode this type to a HeaderMap.