Struct PagedCache 

pub struct PagedCache<K> {
    cache: Cache<(K, u64), Arc<CachedPage>>,
    page_size: u64,
    observer: PageCacheObserver,
}

Caches fixed-size byte pages of immutable content identified by K. File identity must include any version needed to distinguish different contents. Missing pages elected by this fetch are submitted through [RangeReader::read_vec].

Fields

cache: Cache<(K, u64), Arc<CachedPage>>

page_size: u64

observer: PageCacheObserver

Implementations

impl<K: Hash + Eq + Clone + Send + Sync + 'static> PagedCache<K>

pub fn new( name: &str, capacity: u64, page_size: u64, weigher: impl Fn(&(K, u64), &Bytes) -> u32 + Send + Sync + 'static, observer: PageCacheObserver, ) -> Self

Creates an independent cache budget. Zero page size is rejected by fetch.

pub fn invalidate_if( &self, predicate: impl Fn(&K) -> bool + Send + Sync + 'static, ) -> Result<()>

Invalidates completed pages. Concurrent loads are not fenced.

pub async fn contains(&self, file: &K, page_id: u64) -> bool

Looks up a completed page without updating business lookup counters.

pub async fn known_file_size( &self, file: &K, ranges: &[Range<u64>], ) -> Option<u64>

Recovers immutable file size from a requested page already in memory.

pub async fn run_pending_tasks(&self)

Applies pending cache admission and eviction work.

pub async fn fetch<R: RangeReader + ?Sized>( &self, file: K, file_size: u64, ranges: &[Range<u64>], reader: &R, ) -> Result<(Vec<Bytes>, PageFetchStats), Arc<Error>>

Fetches bytes in input order. The reader must address the same immutable content as file. Each successful loader reads one complete missing page.

fn create_cached_page(&self, file_size: u64, bytes: Bytes) -> Arc<CachedPage>

fn observe_residency(&self)