Struct ValidationCache 

pub struct ValidationCache { /* private fields */ }

Thread-safe, TTL-aware validation result cache.

Usage

use oxirs_shacl::cache::validation_cache::{ValidationCache, ValidationCacheKey, CachedValidationResult};
use std::time::Duration;

let cache = ValidationCache::new(1000, Duration::from_secs(300));
let key = ValidationCacheKey::new("http://ex/Alice", "http://ex/PersonShape", 42);
let entry = CachedValidationResult::new(
    "http://ex/Alice",
    "http://ex/PersonShape",
    true,
    vec![],
    Duration::from_secs(300),
);
cache.put(key.clone(), entry);
assert!(cache.get(&key).is_some());

Implementations

impl ValidationCache

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

Create a new cache.

• max_entries — maximum number of entries before LRU eviction kicks in
• ttl — default time-to-live for new entries

pub fn get(&self, key: &ValidationCacheKey) -> Option<CachedValidationResult>

Look up a validation result.

Returns None if the key is not present or the entry is stale. Stale entries are removed on lookup.

pub fn put(&self, key: ValidationCacheKey, result: CachedValidationResult)

Insert or update a validation result.

If the cache is at capacity, the least-recently-used entry is evicted first.

pub fn invalidate_node(&self, focus_node: &str) -> usize

Invalidate all cache entries whose focus_node matches the given string.

Returns the number of entries removed.

pub fn invalidate_triple(&self, triple_key: &str) -> usize

Invalidate all cache entries that accessed the given triple during validation.

Returns the number of entries removed.

pub fn evict_stale(&self) -> usize

Remove all stale (TTL-expired) entries.

Returns the number of entries removed.

pub fn clear(&self)

Clear the entire cache.

pub fn size(&self) -> usize

Return the current number of (non-stale) entries in the cache.

pub fn raw_size(&self) -> usize

Total number of entries (including stale ones not yet evicted).

pub fn hit_rate(&self) -> f64

Cache hit rate (hits / (hits + misses)), or 0.0 when no lookups have occurred.

pub fn stats(&self) -> CacheStats

Returns a snapshot of cache statistics.

pub fn default_ttl(&self) -> Duration

Return the default TTL for this cache instance.

Trait Implementations

impl Clone for ValidationCache

fn clone(&self) -> ValidationCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.