Struct DnsResolver 

pub struct DnsResolver { /* private fields */ }

Per-client DNS and SRV cache.

Cheaply Clone-able — all clones share the same underlying Arc caches. Constructed by McClientBuilder via DnsResolver::new() or DnsResolver::with_cache_size(n).

Implementations

impl DnsResolver

pub fn new() -> Self

Create a resolver with the default LRU capacity (1024 entries per cache).

pub fn with_cache_size(size: usize) -> Self

Create a resolver with a custom LRU capacity.

The same capacity is applied to both the DNS and SRV caches.

Panics

Panics if size is 0.

pub async fn clear(&self)

Clear both the DNS and SRV caches.

pub async fn dns_len(&self) -> usize

Number of entries currently in the DNS cache (including expired ones).

pub async fn srv_len(&self) -> usize

Number of entries currently in the SRV cache (including expired ones).

pub async fn lookup_srv( &self, host: &str, tout: Duration, ) -> Option<(String, u16)>

Look up the _minecraft._tcp.<host> SRV record.

Returns Some((target_host, port)) on success, None on any failure (DNS error, no SRV record, timeout) so callers can transparently fall back to a plain A/AAAA lookup.

Results are cached for [DNS_CACHE_TTL] (5 minutes).

pub async fn resolve( &self, host: &str, port: u16, ) -> Result<(SocketAddr, DnsInfo), McError>

Resolve host:port to a SocketAddr.

Prefers IPv4 addresses when both A and AAAA records are returned. Results are cached for [DNS_CACHE_TTL] (5 minutes).

Resolution is performed in a spawn_blocking task because std::net::ToSocketAddrs is a blocking call.

Errors

Returns McError::Network(Dns) on resolution failure or when no addresses are returned.

Trait Implementations

impl Clone for DnsResolver

fn clone(&self) -> DnsResolver

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for DnsResolver

fn default() -> Self

Returns the “default value” for a type.