RequestCache

Struct RequestCache 

Source
pub struct RequestCache<K, V>
where K: Hash + Eq + Clone + Send + Sync + 'static, V: Clone + Send + Sync + 'static,
{ /* private fields */ }
Expand description

Thread-safe request cache with TTL and LRU eviction.

Implementations§

Source§

impl<K, V> RequestCache<K, V>
where K: Hash + Eq + Clone + Send + Sync + 'static, V: Clone + Send + Sync + 'static,

Source

pub fn new(max_size: usize, default_ttl: Duration) -> Self

Create a new request cache.

Source

pub fn with_config(config: CacheConfig) -> Self

Create a new request cache with custom configuration.

Source

pub async fn get(&self, key: &K) -> Option<V>

Get a value from the cache.

Source

pub async fn insert(&self, key: K, value: V) -> Option<V>

Insert a value into the cache.

Source

pub async fn insert_with_ttl( &self, key: K, value: V, ttl: Duration, ) -> Option<V>

Insert a value with custom TTL.

Source

pub async fn remove(&self, key: &K) -> Option<V>

Remove a value from the cache.

Source

pub async fn contains_key(&self, key: &K) -> bool

Check if the cache contains a key.

Source

pub async fn len(&self) -> usize

Get the number of entries in the cache.

Source

pub async fn is_empty(&self) -> bool

Check if the cache is empty.

Source

pub async fn clear(&self)

Clear all entries from the cache.

Source

pub fn statistics(&self) -> &CacheStatistics

Get cache statistics.

Source

pub async fn cleanup_expired(&self) -> usize

Cleanup expired entries.

Source§

impl RequestCache<RequestCacheKey, Value>

Source

pub fn new_api_cache() -> Self

Create a cache optimized for API requests.

Source

pub async fn cache_response<I: Serialize, O: Serialize>( &self, endpoint: &str, method: &str, request_body: Option<&I>, headers: &HashMap<String, String>, response: &O, ) -> Result<()>

Cache an API response with separate request and response types.

§Errors

Returns an error if cache key generation or value serialization fails.

Source

pub async fn get_response<I: Serialize, O: for<'de> Deserialize<'de>>( &self, endpoint: &str, method: &str, request_body: Option<&I>, headers: &HashMap<String, String>, ) -> Result<Option<O>>

Get a cached API response with separate request and response types.

§Errors

Returns an error if cache key generation or response deserialization fails.

Trait Implementations§

Source§

impl<K, V> Debug for RequestCache<K, V>
where K: Hash + Eq + Clone + Send + Sync + 'static + Debug, V: Clone + Send + Sync + 'static + Debug,

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl<K, V> Freeze for RequestCache<K, V>

§

impl<K, V> !RefUnwindSafe for RequestCache<K, V>

§

impl<K, V> Send for RequestCache<K, V>

§

impl<K, V> Sync for RequestCache<K, V>

§

impl<K, V> Unpin for RequestCache<K, V>

§

impl<K, V> !UnwindSafe for RequestCache<K, V>

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<C, E> EntryToVal<C> for E
where C: Collection<Entry = E>,

Source§

type Val = <C as Collection>::Val

The type of values stored in the collection. This might be distinct from Entry in complex collections. For example, in a HashMap, while Entry might be a ( key, value ) tuple, Val might only be the value part.
Source§

fn entry_to_val(self) -> <E as EntryToVal<C>>::Val

Converts an entry into a value representation specific to the type of collection. This conversion is crucial for handling operations on entries, especially when they need to be treated or accessed as individual values, such as retrieving the value part from a key-value pair in a hash map.
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 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<T> IntoResult<T> for T

Source§

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

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

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

Source§

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

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

Source§

fn vzip(self) -> V

Source§

impl<C, Val> ValToEntry<C> for Val
where C: CollectionValToEntry<Val>,

Source§

fn val_to_entry(self) -> <C as CollectionValToEntry<Val>>::Entry

Invokes the val_to_entry function of the CollectionValToEntry trait to convert the value to an entry.

Source§

type Entry = <C as CollectionValToEntry<Val>>::Entry

Represents the type of entry that corresponds to the value within the collection. Type Entry is defined by the Collection trait.
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