Struct DnsCache 

pub struct DnsCache { /* private fields */ }

An in-memory DNS cache with TTL-based expiry.

Implementations

impl DnsCache

pub fn new() -> Self

Create a new DNS cache with the default TTL (60 seconds).

pub fn with_ttl(ttl: Duration) -> Self

Create a new DNS cache with a custom TTL.

pub const fn set_ttl(&mut self, ttl: Duration)

Set the TTL for new entries added to the cache.

Does not affect already-cached entries.

pub const fn ttl(&self) -> Duration

Returns the current TTL for new entries.

pub fn get(&self, host: &str, port: u16) -> Option<&[SocketAddr]>

Look up a cached DNS entry for the given host and port.

Returns None if no entry exists or the entry has expired.

pub fn put(&mut self, host: &str, port: u16, addrs: Vec<SocketAddr>)

Store resolved addresses in the cache.

pub fn purge_expired(&mut self)

Remove expired entries from the cache.

pub fn clear(&mut self)

Clear all entries from the cache.

pub fn len(&self) -> usize

Returns the number of entries in the cache (including expired).

pub fn is_empty(&self) -> bool

Returns true if the cache has no entries.

Trait Implementations

impl Debug for DnsCache

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

Formats the value using the given formatter.

impl Default for DnsCache

fn default() -> Self

Returns the “default value” for a type.