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
impl CachingAssetResolver
pub fn new(inner: Box<dyn AssetResolver>) -> Self
Sourcepub fn with_max_bytes(self, n: usize) -> Self
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.
Sourcepub fn cache_len(&self) -> usize
pub fn cache_len(&self) -> usize
Number of entries currently cached. Useful for instrumentation.
Sourcepub fn cache_bytes(&self) -> usize
pub fn cache_bytes(&self) -> usize
Total bytes currently held in the cache.
Trait Implementations§
Source§impl AssetResolver for CachingAssetResolver
impl AssetResolver for CachingAssetResolver
Source§fn fetch(&self, uri: &str) -> Result<Vec<u8>, AssetError>
fn fetch(&self, uri: &str) -> Result<Vec<u8>, AssetError>
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>
fn resolve_id(&self, id: &str) -> Option<String>
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§
impl !Freeze for CachingAssetResolver
impl !RefUnwindSafe for CachingAssetResolver
impl !UnwindSafe for CachingAssetResolver
impl Forget for CachingAssetResolver
impl Move for CachingAssetResolver
impl Send for CachingAssetResolver
impl Sync for CachingAssetResolver
impl Unpin for CachingAssetResolver
impl UnsafeUnpin for CachingAssetResolver
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<T> ErasedDestructor for Twhere
T: 'static,
Source§impl<U, T> ToOwnedObj<U> for Twhere
U: FromObjRef<T>,
impl<U, T> ToOwnedObj<U> for Twhere
U: FromObjRef<T>,
Source§fn to_owned_obj(&self, data: FontData<'_>) -> U
fn to_owned_obj(&self, data: FontData<'_>) -> U
T, using the provided data to resolve any offsets.