Struct LanceCache 

pub struct LanceCache { /* private fields */ }

Typed cache wrapper that handles key construction and type safety.

Internally delegates to a CacheBackend. The default backend is MokaCacheBackend; pass a custom backend via LanceCache::with_backend.

Implementations

impl LanceCache

pub fn with_capacity(capacity: usize) -> Self

pub fn with_backend(backend: Arc<dyn CacheBackend>) -> Self

Create a cache backed by a custom CacheBackend.

pub fn no_cache() -> Self

pub fn with_backend_and_prefix( backend: Arc<dyn CacheBackend>, prefix: String, ) -> Self

Create a cache with the given backend and an exact prefix string. Unlike with_key_prefix, this sets the prefix verbatim (no trailing slash added).

pub fn with_key_prefix(&self, prefix: &str) -> Self

Appends a prefix to the cache key.

pub async fn invalidate_prefix(&self, prefix: &str)

Invalidate all entries whose prefix starts with the given string.

pub async fn size(&self) -> usize

pub fn approx_size(&self) -> usize

pub async fn size_bytes(&self) -> usize

pub async fn keys(&self) -> Option<CacheKeyIterator<'_>>

Return an iterator over keys currently stored under this cache’s prefix.

Returns None when the backend does not support key inventory. The iterator is intended for diagnostics and may be weakly consistent with concurrent cache mutations.

Examples

let cache = LanceCache::with_capacity(1024);
cache.insert_with_key(&MyKey, Arc::new(vec![1, 2, 3])).await;

let mut keys = cache.keys().await.expect("Moka supports key inventory");
assert_eq!(keys.next().unwrap().key(), "my-key");

pub async fn stats(&self) -> CacheStats

pub async fn clear(&self)

pub async fn insert_with_key<K>( &self, cache_key: &K, metadata: Arc<K::ValueType>, )

where K: CacheKey, K::ValueType: DeepSizeOf + Send + Sync + 'static,

pub async fn get_with_key<K>(&self, cache_key: &K) -> Option<Arc<K::ValueType>>

where K: CacheKey, K::ValueType: DeepSizeOf + Send + Sync + 'static,

pub async fn get_or_insert_with_key<K, F, Fut>( &self, cache_key: K, loader: F, ) -> Result<Arc<K::ValueType>>

where K: CacheKey, K::ValueType: DeepSizeOf + Send + Sync + 'static, F: FnOnce() -> Fut + Send, Fut: Future<Output = Result<K::ValueType>> + Send,

pub async fn insert_unsized_with_key<K>( &self, cache_key: &K, metadata: Arc<K::ValueType>, )

where K: UnsizedCacheKey, K::ValueType: DeepSizeOf + Send + Sync + 'static,

pub async fn get_unsized_with_key<K>( &self, cache_key: &K, ) -> Option<Arc<K::ValueType>>

where K: UnsizedCacheKey, K::ValueType: DeepSizeOf + Send + Sync + 'static,

Trait Implementations

impl Clone for LanceCache

fn clone(&self) -> LanceCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LanceCache

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

Formats the value using the given formatter.

impl DeepSizeOf for LanceCache

fn deep_size_of_children(&self, _: &mut Context) -> usize

fn deep_size_of(&self) -> usize