Struct SegmentCache 

pub struct SegmentCache { /* private fields */ }

Bounded read-through cache. Without a disk configuration it remains a bounded in-memory cache; its default capacity is 64 MiB.

Implementations

impl SegmentCache

pub fn memory_only(capacity_bytes: u64) -> Self

Creates a byte-bounded memory-only cache.

pub fn open(config: &SegmentCacheConfig) -> Result<Self>

Opens and reconciles an SSD cache, acquiring its exclusive ownership lock.

Errors

Returns an error for invalid configuration, inaccessible storage, or when another process owns the directory.

pub fn metrics(&self) -> Arc<SegmentCacheMetrics>

Returns the cache’s metrics handle.

pub async fn get_or_load( &self, store: &dyn SegmentReader, id: &BlobId, ) -> Result<Option<Arc<[u8]>>, StoreError>

Returns cached bytes, loading and verifying the authoritative store on miss.

Errors

Returns errors from authoritative storage, including corrupt native bytes.

Panics

Panics if an internal cache mutex was poisoned by another panicking thread.

Trait Implementations

impl Default for SegmentCache

fn default() -> Self

Returns the “default value” for a type.