Enum CachePolicy 

pub enum CachePolicy {
    NoStore,
    NoCache,
    Immutable {
        max_age_secs: u32,
    },
    Public {
        max_age_secs: u32,
        stale_while_revalidate_secs: Option<u32>,
        stale_if_error_secs: Option<u32>,
    },
    Private {
        max_age_secs: u32,
    },
}

Describes how a response should be cached by browsers and CDNs.

Variants

NoStore

no-store — prohibit all caching.

NoCache

no-cache — revalidate on every request via ETag/Last-Modified.

Immutable

public, max-age=X, immutable — ideal for content-addressed URLs.

Fields

max_age_secs: u32

Seconds the response may be served from cache without revalidation.

Public

public, max-age=X [, stale-while-revalidate=Y] [, stale-if-error=Z]

Fields

max_age_secs: u32

Seconds the response is considered fresh.

stale_while_revalidate_secs: Option<u32>

Allow stale serving while revalidating in the background.

stale_if_error_secs: Option<u32>

Allow stale serving when the origin is returning errors.

Private

private, max-age=X — browser-only; never cached by shared caches.

Fields

max_age_secs: u32

Seconds the response may be served from the private cache.

Implementations

impl CachePolicy

pub fn to_header_value(&self) -> String

Formats this policy as a Cache-Control header value.

pub fn tile_default() -> Self

Default policy for map tiles: 1 h fresh, 60 s stale-while-revalidate, 24 h stale-if-error.

pub fn metadata_default() -> Self

Default policy for dataset/layer metadata: 5 min fresh, 30 s swr, 1 h sie.

pub fn static_asset() -> Self

Policy for static assets referenced by content hash: 1 year, immutable.

pub fn api_response() -> Self

Policy for dynamic API responses: 60 s fresh, 10 s swr, 10 min sie.

Trait Implementations

impl Clone for CachePolicy

fn clone(&self) -> CachePolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CachePolicy

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

Formats the value using the given formatter.

impl PartialEq for CachePolicy

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for CachePolicy

impl StructuralPartialEq for CachePolicy