Struct BlockCacheStorage 

pub struct BlockCacheStorage { /* private fields */ }

Block-aligned LRU cache for any random-access storage backend.

This is useful when the underlying storage is remote or has high per-request latency. Reads are rounded out to fixed-size blocks and cached by block number; callers still see the normal Storage::read_range interface.

Implementations

impl BlockCacheStorage

pub fn new( inner: Arc<dyn Storage>, block_size: usize, max_blocks: usize, ) -> BlockCacheStorage

Create a block cache around an existing storage backend.

block_size and max_blocks values of zero are normalized to 1.

pub fn with_defaults(inner: Arc<dyn Storage>) -> BlockCacheStorage

Create a block cache with conservative defaults: 1 MiB blocks, 128 slots.

pub fn stats(&self) -> BlockCacheStats

Return current cache statistics.

Trait Implementations

impl Storage for BlockCacheStorage

fn len(&self) -> u64

Total length in bytes.

fn read_range(&self, offset: u64, len: usize) -> Result<StorageBuffer, Error>

Read a byte range from offset..offset+len.

fn is_empty(&self) -> bool

Returns true if the storage is empty.