Struct PageCacheShard 

pub struct PageCacheShard { /* private fields */ }

SIEVE-based page cache

Thread-safe page cache using the SIEVE eviction algorithm.

Implementations

impl PageCacheShard

pub fn new(capacity: usize) -> Self

Create a new page cache with specified capacity

pub fn with_default_capacity() -> Self

Create a page cache with default capacity

pub fn len(&self) -> usize

Get the current number of cached pages

pub fn is_empty(&self) -> bool

Check if cache is empty

pub fn capacity(&self) -> usize

Get cache capacity

pub fn stats(&self) -> CacheStats

Get cache statistics

pub fn reset_stats(&self)

Reset statistics

pub fn get(&self, page_id: u32) -> Option<Page>

Get a page from cache

Returns None if page is not in cache (cache miss). On hit, marks the page as visited (SIEVE).

pub fn insert(&self, page_id: u32, page: Page) -> Option<Page>

Insert a page into cache

May trigger eviction if cache is full. Returns the evicted page (if dirty) that needs to be written back.

pub fn mark_dirty(&self, page_id: u32)

Mark a page as dirty

pub fn mark_clean(&self, page_id: u32)

Mark a page as clean

pub fn pin(&self, page_id: u32) -> bool

Pin a page (prevent eviction)

pub fn unpin(&self, page_id: u32) -> bool

Unpin a page

pub fn remove(&self, page_id: u32) -> Option<Page>

Remove a page from cache

pub fn flush_dirty(&self) -> Vec<(u32, Page)>

Flush all dirty pages

Returns an iterator of (page_id, page) for dirty pages.

pub fn flush_some_dirty(&self, max: usize) -> Vec<(u32, Page)>

Bounded counterpart of flush_dirty used by the background writer. Snapshots up to max dirty pages, marks them clean, and returns the (page_id, page) pairs for the caller to persist via the pager. Clamps to the current dirty set — returning fewer than max simply means we’re caught up.

pub fn dirty_count(&self) -> usize

Count dirty pages currently in the cache. Used by the background writer to compute an adaptive flush budget.

pub fn clear(&self)

Clear all entries from cache

pub fn contains(&self, page_id: u32) -> bool

Check if a page is in cache

pub fn page_ids(&self) -> Vec<u32>

Get all cached page IDs

Trait Implementations

impl Default for PageCacheShard

fn default() -> Self

Returns the “default value” for a type.