Struct OriginProbeMemo 

pub struct OriginProbeMemo { /* private fields */ }

Bounded, lazily-expiring memo of origin-probe answers.

Implementations

impl OriginProbeMemo

pub fn new(policy: OriginProbePolicy) -> Self

A memo under policy. A capacity of 0 is treated as 1 so the map can always hold the entry it just resolved.

pub const fn fault_ttl(&self) -> Duration

How long a memoised Fault answer stands before the origin is re-probed.

pub const fn timeout(&self) -> Duration

The per-probe live-HEAD ceiling this memo was configured with.

pub fn get(&mut self, hash: Hash, now: Instant) -> Option<Presence>

A live (non-expired) memoised answer for hash, or None on a miss. Expired entries are swept in passing so a stale answer is never returned and the map does not accrete dead entries on the read path.

pub fn insert(&mut self, hash: Hash, presence: Presence, now: Instant)

Record presence for hash, valid for one TTL from now. Enforces the capacity bound: expired entries are swept first, and if the map is still at capacity one arbitrary live entry is dropped to make room, so the memo can never exceed capacity distinct hashes regardless of probe volume.

pub fn len(&self) -> usize

Number of memoised entries (test/introspection aid).

pub fn is_empty(&self) -> bool

Whether the memo holds no entries.

Trait Implementations

impl Debug for OriginProbeMemo

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for OriginProbeMemo

fn default() -> Self

Returns the “default value” for a type.