Struct HickoryResolver 

pub struct HickoryResolver { /* private fields */ }

A DNS resolver for hyper based on hickory.

Implementations

impl HickoryResolver

pub fn from_system_conf() -> Result<Self, GenericError>

Creates a new HickoryResolver based on the system’s resolver configuration.

Panics

This will panic if called outside the context of a Tokio runtime.

Errors

If there is an issue loading the system configuration, an error is returned.

pub fn noop() -> Self

Creates a placeholder HickoryResolver with no configured nameservers.

This resolver will never successfully resolve any names. It exists solely as a placeholder for code paths where DNS resolution is never needed (for example, vsock transport), avoiding initialization failures in environments without system DNS configuration such as Nitro Enclaves.

pub fn with_lookup_errors_counter(self, counter: Counter) -> Self

Sets a counter that’s incremented when DNS lookup fails.

pub fn into_http_connector(self) -> HickoryHttpConnector

Consumes self and creates a new HickoryHttpConnector with this resolver.

Trait Implementations

impl Clone for HickoryResolver

fn clone(&self) -> HickoryResolver

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Service<Name> for HickoryResolver

type Response = SocketAddrs

Responses given by the service.

type Error = NetError

Errors produced by the service.

type Future = Pin<Box<dyn Future<Output = Result<<HickoryResolver as Service<Name>>::Response, <HickoryResolver as Service<Name>>::Error>> + Send>>

The future response value.

fn poll_ready(&mut self, _cx: &mut Context<'_>) -> Poll<Result<(), Self::Error>>

Returns Poll::Ready(Ok(())) when the service is able to process requests.

fn call(&mut self, name: Name) -> Self::Future

Process the request and return the response asynchronously.