pub struct FallbackCache<Primary, Fallback> { /* private fields */ }
Expand description

FallbackCache is a combinator for the ModuleCache trait that enables the chaining of two caching strategies together, typically via ModuleCache::with_fallback().

All operations are attempted using primary cache first, and if that fails, falls back to using the fallback cache. By chaining different caches together with FallbackCache, you can create a caching hierarchy tailored to your application’s specific needs, balancing performance, resource usage, and persistence.

A key assumption of FallbackCache is that all operations on the fallback implementation will be significantly slower than the primary one.

Cache Promotion

Whenever there is a cache miss on the primary cache and the fallback is able to load a module, that module is automatically added to the primary cache to improve the speed of future lookups.

This “cache promotion” strategy helps keep frequently accessed modules in the faster primary cache.

Implementations§

source§

impl<Primary, Fallback> FallbackCache<Primary, Fallback>

source

pub fn primary(&self) -> &Primary

source

pub fn primary_mut(&mut self) -> &mut Primary

source

pub fn fallback(&self) -> &Fallback

source

pub fn fallback_mut(&mut self) -> &mut Fallback

source

pub fn into_inner(self) -> (Primary, Fallback)

Trait Implementations§

source§

impl<Primary: Clone, Fallback: Clone> Clone for FallbackCache<Primary, Fallback>

source§

fn clone(&self) -> FallbackCache<Primary, Fallback>

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl<Primary: Debug, Fallback: Debug> Debug for FallbackCache<Primary, Fallback>

source§

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

Formats the value using the given formatter. Read more
source§

impl<Primary: Hash, Fallback: Hash> Hash for FallbackCache<Primary, Fallback>

source§

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher. Read more
1.3.0 · source§

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
source§

impl<Primary, Fallback> ModuleCache for FallbackCache<Primary, Fallback>where Primary: ModuleCache + Send + Sync, Fallback: ModuleCache + Send + Sync,

source§

fn load<'life0, 'life1, 'async_trait>( &'life0 self, key: ModuleHash, engine: &'life1 Engine ) -> Pin<Box<dyn Future<Output = Result<Module, CacheError>> + Send + 'async_trait>>where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Load a module based on its hash.
source§

fn save<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, key: ModuleHash, engine: &'life1 Engine, module: &'life2 Module ) -> Pin<Box<dyn Future<Output = Result<(), CacheError>> + Send + 'async_trait>>where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Save a module so it can be retrieved with ModuleCache::load() at a later time. Read more
source§

fn with_fallback<C>(self, other: C) -> FallbackCache<Self, C>where Self: Sized, C: ModuleCache,

Chain a second ModuleCache that will be used as a fallback if lookups on the primary cache fail. Read more
source§

impl<Primary: PartialEq, Fallback: PartialEq> PartialEq<FallbackCache<Primary, Fallback>> for FallbackCache<Primary, Fallback>

source§

fn eq(&self, other: &FallbackCache<Primary, Fallback>) -> bool

This method tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl<Primary: Eq, Fallback: Eq> Eq for FallbackCache<Primary, Fallback>

source§

impl<Primary, Fallback> StructuralEq for FallbackCache<Primary, Fallback>

source§

impl<Primary, Fallback> StructuralPartialEq for FallbackCache<Primary, Fallback>

Auto Trait Implementations§

§

impl<Primary, Fallback> RefUnwindSafe for FallbackCache<Primary, Fallback>where Fallback: RefUnwindSafe, Primary: RefUnwindSafe,

§

impl<Primary, Fallback> Send for FallbackCache<Primary, Fallback>where Fallback: Send, Primary: Send,

§

impl<Primary, Fallback> Sync for FallbackCache<Primary, Fallback>where Fallback: Sync, Primary: Sync,

§

impl<Primary, Fallback> Unpin for FallbackCache<Primary, Fallback>where Fallback: Unpin, Primary: Unpin,

§

impl<Primary, Fallback> UnwindSafe for FallbackCache<Primary, Fallback>where Fallback: UnwindSafe, Primary: UnwindSafe,

Blanket Implementations§

source§

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

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
§

impl<T> ArchivePointee for T

§

type ArchivedMetadata = ()

The archived version of the pointer metadata for this type.
§

fn pointer_metadata( _: &<T as ArchivePointee>::ArchivedMetadata ) -> <T as Pointee>::Metadata

Converts some archived metadata to the pointer metadata for itself.
source§

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

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

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

source§

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

Mutably borrows from an owned value. Read more
§

impl<T> CallHasher for Twhere T: Hash + ?Sized,

§

default fn get_hash<H, B>(value: &H, build_hasher: &B) -> u64where H: Hash + ?Sized, B: BuildHasher,

§

impl<F, W, T, D> Deserialize<With<T, W>, D> for Fwhere W: DeserializeWith<F, T, D>, D: Fallible + ?Sized, F: ?Sized,

§

fn deserialize( &self, deserializer: &mut D ) -> Result<With<T, W>, <D as Fallible>::Error>

Deserializes using the given deserializer
source§

impl<Q, K> Equivalent<K> for Qwhere Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for Twhere 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.

§

impl<T> LayoutRaw for T

§

fn layout_raw(_: <T as Pointee>::Metadata) -> Result<Layout, LayoutError>

Gets the layout of the type.
§

impl<T> Pointee for T

§

type Metadata = ()

The type for metadata in pointers and references to Self.
source§

impl<T> Same<T> for T

§

type Output = T

Should always be Self
source§

impl<T> ToOwned for Twhere T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

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

§

type Error = Infallible

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

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

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

§

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.
source§

impl<T> Upcastable for Twhere T: Any + Debug + 'static,

source§

fn upcast_any_ref(&self) -> &(dyn Any + 'static)

source§

fn upcast_any_mut(&mut self) -> &mut (dyn Any + 'static)

source§

fn upcast_any_box(self: Box<T, Global>) -> Box<dyn Any, Global>

§

impl<T> Upcastable for Twhere T: Any + Send + Sync + 'static,

§

fn upcast_any_ref(&self) -> &(dyn Any + 'static)

upcast ref
§

fn upcast_any_mut(&mut self) -> &mut (dyn Any + 'static)

upcast mut ref
§

fn upcast_any_box(self: Box<T, Global>) -> Box<dyn Any, Global>

upcast boxed dyn
§

impl<V, T> VZip<V> for Twhere V: MultiLane<T>,

§

fn vzip(self) -> V

source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more