Struct CacheEntry 

pub struct CacheEntry { /* private fields */ }

The result of a lookup: the object (if found), and/or an obligation to fetch.

Implementations

impl CacheEntry

pub fn with_always_use_requested_range( self, always_use_requested_range: bool, ) -> Self

Set the always_use_requested_range flag. This applies to all subsequent lookups from this CacheEntry or future entries derived from it.

pub fn stub(&self) -> CacheEntry

Return a stub entry to hold in CacheBusy.

pub fn key(&self) -> &CacheKey

Returns the key used to generate this CacheEntry.

pub fn found(&self) -> Option<&Found>

Returns the data found in the cache, if any was present.

pub fn found_mut(&mut self) -> Option<&mut Found>

Returns the data found in the cache, if any was present.

pub fn go_get(&self) -> Option<&Obligation>

Returns the obligation to fetch, if required

pub fn cancel(&mut self) -> bool

Ignore the obligation to fetch, if present. Returns true if it actually canceled an obligation.

pub async fn body( &self, from: Option<u64>, to: Option<u64>, ) -> Result<Body, Error>

Access the body of the cached item, if available.

pub fn insert( &mut self, options: WriteOptions, body: Body, ) -> Result<CacheEntry, Error>

Insert the provided body into the cache.

Returns a CacheEntry where the new item is Found.

pub async fn update(&mut self, options: WriteOptions) -> Result<(), Error>

Freshen the existing cache item according to the new write options, without changing the body.

Trait Implementations

impl Debug for CacheEntry

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

Formats the value using the given formatter.