Struct QueryCache 

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

Thread-safe query cache with LRU eviction.

The QueryCache stores query results with a TTL (time-to-live) and evicts oldest entries when the cache is full.

Examples

use forgekit_core::cache::QueryCache;
use std::time::Duration;

let cache = QueryCache::<String, String>::new(100, Duration::from_secs(300));

// Insert a value
cache.insert("key".to_string(), "value".to_string()).await;

// Retrieve it
if let Some(value) = cache.get(&"key".to_string()).await {
    println!("Cached: {}", value);
}

Implementations

impl<K, V> QueryCache<K, V>

where K: Clone + Eq + Hash + Send + Sync + 'static, V: Clone + Send + Sync + 'static,

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

Creates a new query cache.

Arguments

• max_size - Maximum number of entries before eviction
• ttl - Time-to-live for cache entries

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

Gets a cached value if it exists and hasn’t expired.

Arguments

• key - The cache key

Returns

Some(value) if cached and valid, None otherwise.

pub async fn insert(&self, key: K, value: V)

Inserts a value into the cache.

If the cache is full, the oldest entry is evicted (FIFO).

Arguments

• key - The cache key
• value - The value to cache

pub async fn invalidate(&self, key: &K)

Invalidates a specific cache entry.

Arguments

• key - The cache key to invalidate

pub async fn clear(&self)

Clears all cached entries.

pub async fn len(&self) -> usize

Returns the current number of cached entries.

pub async fn is_empty(&self) -> bool

Returns true if the cache is empty.

Trait Implementations

impl<K, V> Clone for QueryCache<K, V>

where K: Clone + Eq + Hash + Send + Sync + 'static + Clone, V: Clone + Send + Sync + 'static + Clone,

fn clone(&self) -> QueryCache<K, V>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<K, V> Debug for QueryCache<K, V>

where K: Clone + Eq + Hash + Send + Sync + 'static, V: Clone + Send + Sync + 'static,

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

Formats the value using the given formatter.