Struct Cache

pub struct Cache {
    inner: PartitionedCache<DomainName, RecordType, RecordTypeWithData>,
}

Caching for ResourceRecords.

You probably want to use SharedCache instead.

Fields

inner: PartitionedCache<DomainName, RecordType, RecordTypeWithData>

Implementations

impl Cache

pub fn new() -> Self

Create a new cache with a default desired size.

pub fn with_desired_size(desired_size: usize) -> Self

Create a new cache with the given desired size.

The prune method will remove expired entries, and also enough entries (in least-recently-used order) to get down to this size.

pub fn get( &mut self, name: &DomainName, qtype: QueryType, ) -> Vec<ResourceRecord>

Get RRs from the cache.

The TTL in the returned ResourceRecord is relative to the current time - not when the record was inserted into the cache.

pub fn get_without_checking_expiration( &mut self, name: &DomainName, qtype: QueryType, ) -> Vec<ResourceRecord>

Like get, but may return expired RRs.

Consumers MUST check that the TTL of a record is nonzero before using it!

pub fn insert(&mut self, record: &ResourceRecord)

Insert an RR into the cache.

pub fn prune(&mut self) -> (bool, usize, usize, usize)

Clear expired RRs and, if the cache has grown beyond its desired size, prunes domains to get down to size.

Returns (has overflowed?, current size, num expired, num pruned).

Trait Implementations

impl Clone for Cache

fn clone(&self) -> Cache

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Cache

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

Formats the value using the given formatter.

impl Default for Cache

fn default() -> Self

Returns the “default value” for a type.