Struct CacheOptions 

pub struct CacheOptions { /* private fields */ }

Configuration that controls cache behavior.

Implementations

impl CacheOptions

pub fn is_shared(&self) -> bool

Returns a copy of whether the cache is treated as a shared cache

Shared cache, suitable for a proxy or cdn: s-maxage is honored, private responses are refused, and Authorization-bearing requests require explicit opt-in (public, s-maxage, or must-revalidate)

Non-shared-cache (the default) treats the cache as a single-user (browser-style) private cache.

Default: false

pub fn shared_mut(&mut self) -> &mut bool

Mutably borrow whether the cache is treated as a shared cache

Shared cache, suitable for a proxy or cdn: s-maxage is honored, private responses are refused, and Authorization-bearing requests require explicit opt-in (public, s-maxage, or must-revalidate)

Non-shared-cache (the default) treats the cache as a single-user (browser-style) private cache.

Default: false

pub fn set_shared(&mut self, shared: bool) -> &mut Self

Sets whether the cache is treated as a shared cache, returning &mut Self for chaining

Shared cache, suitable for a proxy or cdn: s-maxage is honored, private responses are refused, and Authorization-bearing requests require explicit opt-in (public, s-maxage, or must-revalidate)

Non-shared-cache (the default) treats the cache as a single-user (browser-style) private cache.

Default: false

pub fn with_shared(self, shared: bool) -> Self

Owned chainable setter for whether the cache is treated as a shared cache, returning Self

Shared cache, suitable for a proxy or cdn: s-maxage is honored, private responses are refused, and Authorization-bearing requests require explicit opt-in (public, s-maxage, or must-revalidate)

Non-shared-cache (the default) treats the cache as a single-user (browser-style) private cache.

Default: false

pub fn cache_heuristic(&self) -> f32

Returns a copy of heuristic-freshness ratio

When a response has no explicit expiration but does have Last-Modified, freshness lifetime is computed as cache_heuristic * (Date - Last-Modified).

Default: 0.1 (10%)

pub fn cache_heuristic_mut(&mut self) -> &mut f32

Mutably borrow heuristic-freshness ratio

When a response has no explicit expiration but does have Last-Modified, freshness lifetime is computed as cache_heuristic * (Date - Last-Modified).

Default: 0.1 (10%)

pub fn set_cache_heuristic(&mut self, cache_heuristic: f32) -> &mut Self

Sets heuristic-freshness ratio, returning &mut Self for chaining

When a response has no explicit expiration but does have Last-Modified, freshness lifetime is computed as cache_heuristic * (Date - Last-Modified).

Default: 0.1 (10%)

pub fn with_cache_heuristic(self, cache_heuristic: f32) -> Self

Owned chainable setter for heuristic-freshness ratio, returning Self

When a response has no explicit expiration but does have Last-Modified, freshness lifetime is computed as cache_heuristic * (Date - Last-Modified).

Default: 0.1 (10%)

pub fn immutable_min_time_to_live(&self) -> Duration

Returns a copy of the default freshness lifetime for responses with Cache-Control: immutable and no other expiration

Default: 24h

pub fn immutable_min_time_to_live_mut(&mut self) -> &mut Duration

Mutably borrow the default freshness lifetime for responses with Cache-Control: immutable and no other expiration

Default: 24h

pub fn set_immutable_min_time_to_live( &mut self, immutable_min_time_to_live: Duration, ) -> &mut Self

Sets the default freshness lifetime for responses with Cache-Control:, returning &mut Self for chaining immutable and no other expiration

Default: 24h

pub fn with_immutable_min_time_to_live( self, immutable_min_time_to_live: Duration, ) -> Self

Owned chainable setter for the default freshness lifetime for responses with Cache-Control:, returning Self immutable and no other expiration

Default: 24h

Trait Implementations

impl Clone for CacheOptions

fn clone(&self) -> CacheOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CacheOptions

impl Debug for CacheOptions

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

Formats the value using the given formatter.

impl Default for CacheOptions

fn default() -> Self

Returns the “default value” for a type.