Struct HeaderCache 

pub struct HeaderCache { /* private fields */ }

A per-mount cache of resolved files keyed by track id; an entry self-invalidates when the track’s content_version changes. Backed by quick_cache: S3-FIFO eviction, byte-weighted, internally sharded.

Implementations

impl HeaderCache

pub fn new(mode: Mode) -> HeaderCache

pub fn with_budget(mode: Mode, budget: u64) -> HeaderCache

pub fn retain(&self, live: &HashSet<i64>)

Drop cached resolutions for tracks no longer present (live = current ids).

pub fn remove(&self, id: i64)

Drop one track’s cached resolution (changelog-refresh removal path).

pub fn resolve<M>(&self, db: &Db<M>, track_id: i64) -> Result<Arc<ResolvedFile>>

Resolve a track to its layout, caching on a content-version miss. Validation (stat) and synthesis run outside the cache; quick_cache’s internal locks are only touched by the brief get and insert.

pub fn entry_count(&self) -> u64

Current number of cached resolved-file entries.

pub fn weight_bytes(&self) -> u64

Current resident inline-byte weight.

pub fn budget_bytes(&self) -> u64

Configured resident-byte budget.

pub fn raw_hits(&self) -> u64

Raw key-hit count (NOT content-version-validated hits — see telemetry docs).

pub fn raw_misses(&self) -> u64

Raw key-miss count.