Struct Cache 

pub struct Cache<S: CacheStorage> { /* private fields */ }

Cache handler. Mount on a trillium_client::Client together with a CacheStorage backend.

Cache is cheap to Clone: storage is held in an Arc, so clones share the same backend.

Implementations

impl<S: CacheStorage> Cache<S>

pub fn new(storage: S) -> Self

Construct a cache handler with default options (CacheOptions::default) and a 16 MiB body-size cap.

pub fn with_options(self, options: CacheOptions) -> Self

Replace the cache options.

pub fn shared(self) -> Self

Mark this cache as a shared cache (proxy/CDN). Equivalent to with_options with shared: true.

pub fn with_max_cacheable_size(self, max: u64) -> Self

Set the cap on response body bytes the cache will store. Responses larger than this pass through but are not stored. If the cap is exceeded mid-stream, the cache write is aborted and the remainder of the body passes through unmodified.

pub fn storage(&self) -> &S

Borrow the storage backend.

Trait Implementations

impl<S: CacheStorage> ClientHandler for Cache<S>

async fn run(&self, conn: &mut Conn) -> Result<()>

Forward-pass hook, called before the network round-trip in declared order.

async fn after_response(&self, conn: &mut Conn) -> Result<()>

Reverse-pass hook, called after the network round-trip (or after a halt-skipped network call) in reverse declared order. Always runs regardless of halt status or transport error.

fn name(&self) -> Cow<'static, str>

Human-readable name for logging/debugging. Defaults to the type name.

impl<S: CacheStorage> Clone for Cache<S>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: Debug + CacheStorage> Debug for Cache<S>

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

Formats the value using the given formatter.