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 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

Returns an estimation of the heap-managed storage of this object. This does not include the size of the object itself.

fn deep_size_of(&self) -> usize

Returns an estimation of a total size of memory owned by the object, including heap-managed storage.