Trait fastly::experimental::RequestCacheKey

pub trait RequestCacheKey {
    fn set_cache_key(&mut self, key: [u8; 32]);
    fn with_cache_key(self, key: [u8; 32]) -> Self;
    fn set_cache_key_fn(
        &mut self, 
        f: impl Fn(&Request) -> [u8; 32] + Send + Sync + 'static
    );
    fn with_cache_key_fn(
        self, 
        f: impl Fn(&Request) -> [u8; 32] + Send + Sync + 'static
    ) -> Self;
    fn set_cache_key_str(&mut self, key_str: impl AsRef<[u8]>);
    fn with_cache_key_str(self, key_str: impl AsRef<[u8]>) -> Self;
}

An extension trait for Requests that adds methods for controlling cache keys.

Stability

This is part of an experimental API that is subject to change or removal even in minor versions of this crate.

Required methods

fn set_cache_key(&mut self, key: [u8; 32])

See Request::set_cache_key().

Stability

This is part of an experimental API that is subject to change or removal even in minor versions of this crate.

fn with_cache_key(self, key: [u8; 32]) -> Self

See Request::with_cache_key().

Stability

This is part of an experimental API that is subject to change or removal even in minor versions of this crate.

fn set_cache_key_fn(
    &mut self,
    f: impl Fn(&Request) -> [u8; 32] + Send + Sync + 'static
)

See Request::set_cache_key_fn().

Stability

This is part of an experimental API that is subject to change or removal even in minor versions of this crate.

fn with_cache_key_fn(
    self,
    f: impl Fn(&Request) -> [u8; 32] + Send + Sync + 'static
) -> Self

See Request::with_cache_key_fn().

Stability

This is part of an experimental API that is subject to change or removal even in minor versions of this crate.

fn set_cache_key_str(&mut self, key_str: impl AsRef<[u8]>)

See Request::set_cache_key_str().

Stability

This is part of an experimental API that is subject to change or removal even in minor versions of this crate.

fn with_cache_key_str(self, key_str: impl AsRef<[u8]>) -> Self

See Request::with_cache_key_str().

Stability

This is part of an experimental API that is subject to change or removal even in minor versions of this crate.

Implementors

impl RequestCacheKey for Request

fn set_cache_key(&mut self, key: [u8; 32])

Set the cache key to be used when attempting to satisfy this request from a cached response.

Stability

This is part of an experimental API that is subject to change or removal even in minor versions of this crate.

fn with_cache_key(self, key: [u8; 32]) -> Self

Builder-style equivalent of set_cache_key().

Stability

This is part of an experimental API that is subject to change or removal even in minor versions of this crate.

fn set_cache_key_fn(
    &mut self,
    f: impl Fn(&Request) -> [u8; 32] + Send + Sync + 'static
)

Set the function that will be used to compute the cache key for this request.

Stability

This is part of an experimental API that is subject to change or removal even in minor versions of this crate.

fn with_cache_key_fn(
    self,
    f: impl Fn(&Request) -> [u8; 32] + Send + Sync + 'static
) -> Self

Builder-style equivalent of set_cache_key_fn().

Stability

This is part of an experimental API that is subject to change or removal even in minor versions of this crate.

fn set_cache_key_str(&mut self, key_str: impl AsRef<[u8]>)

Set a string as the cache key to be used when attempting to satisfy this request from a cached response.

The string representation of the key is hashed to the same [u8; 32] representation used by set_cache_key().

Stability

This is part of an experimental API that is subject to change or removal even in minor versions of this crate.

fn with_cache_key_str(self, key_str: impl AsRef<[u8]>) -> Self

Builder-style equivalent of set_cache_key_str().

Stability

This is part of an experimental API that is subject to change or removal even in minor versions of this crate.