Skip to main content

CachingAssetResolver

Struct CachingAssetResolver 

Source
pub struct CachingAssetResolver { /* private fields */ }
Expand description

Caches successful fetches by URI so repeated references to the same asset hit the inner resolver only once.

Optional byte cap: when set via Self::with_max_bytes, the cache evicts least-recently-used entries to keep total cached body size under the cap. A single entry larger than the cap is fetched but not cached. Without a cap, the cache grows unbounded — fine for short-lived single-doc renders, dangerous for long-running services.

Errors are not cached — transient failures retry on the next call, and AssetError::Io isn’t Clone-able anyway.

Thread-safe (Send + Sync); the cache is behind a Mutex.

Implementations§

Source§

impl CachingAssetResolver

Source

pub fn new(inner: Box<dyn AssetResolver>) -> Self

Source

pub fn with_max_bytes(self, n: usize) -> Self

Limit total cached body size (in bytes). When inserting would exceed this, the least-recently-used entries are evicted until the new entry fits. Single entries larger than the cap are not cached but still served from the inner resolver.

Source

pub fn cache_len(&self) -> usize

Number of entries currently cached. Useful for instrumentation.

Source

pub fn cache_bytes(&self) -> usize

Total bytes currently held in the cache.

Source

pub fn clear(&self)

Drop all cached entries.

Trait Implementations§

Source§

impl AssetResolver for CachingAssetResolver

Source§

fn fetch(&self, uri: &str) -> Result<Vec<u8>, AssetError>

Fetch the bytes referenced by uri. The URI can be a relative or absolute path, an http:// / https:// URL, an asset-service reference, or anything else a caller-supplied resolver knows how to handle.
Source§

fn resolve_id(&self, id: &str) -> Option<String>

Resolve a bare asset id (no path, no extension — e.g. an asset service’s UUID) to a URI that fetch can load. A filesystem resolver searches its root recursively for a file whose stem matches; resolvers that can’t map an id return None (the default). Used as a fallback for {% media id="…" /%} when the id isn’t a file sitting directly in the asset root.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> ErasedDestructor for T
where T: 'static,

Source§

impl<T> Finish for T

Source§

fn finish(self)

Does nothing but move self, equivalent to drop.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<U, T> ToOwnedObj<U> for T
where U: FromObjRef<T>,

Source§

fn to_owned_obj(&self, data: FontData<'_>) -> U

Convert this type into T, using the provided data to resolve any offsets.
Source§

impl<U, T> ToOwnedTable<U> for T
where U: FromTableRef<T>,

Source§

fn to_owned_table(&self) -> U

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.