Struct HickoryResolver

pub struct HickoryResolver<C: ConnectionProvider> { /* private fields */ }

A hyper resolver using hickory’s Resolver and any implementor of ConnectionProvider.

Implementations

impl HickoryResolver<GenericConnector<TokioRuntimeProvider>>

pub fn new() -> Self

Available on crate feature tokio only.

Create a new TokioHickoryResolver with the default config options. This must be run inside a Tokio runtime context.

pub fn google() -> Self

Available on crate feature tokio only.

Create a new TokioHickoryResolver that uses the Google nameservers. This must be run inside a Tokio runtime context.

pub fn cloudflare() -> Self

Available on crate feature tokio only.

Create a new TokioHickoryResolver that uses the Cloudflare nameservers. This must be run inside a Tokio runtime context.

pub fn cloudflare_https() -> Self

Available on crate feature tokio and (crate features https-aws-lc-rs or https-ring) only.

Create a new TokioHickoryResolver that uses the Cloudflare nameservers. This limits the registered connections to just HTTPS lookups. This must be run inside a Tokio runtime context.

pub fn cloudflare_tls() -> Self

Available on crate feature tokio and (crate features tls-aws-lc-rs or tls-ring) only.

Create a new TokioHickoryResolver that uses the Cloudflare nameservers. This limits the registered connections to just TLS lookups. This must be run inside a Tokio runtime context.

pub fn quad9() -> Self

Available on crate feature tokio only.

Create a new TokioHickoryResolver that uses the Quad9 nameservers. This must be run inside a Tokio runtime context.

pub fn quad9_https() -> Self

Available on crate feature tokio and (crate features https-aws-lc-rs or https-ring) only.

Create a new TokioHickoryResolver that uses the Quad9 nameservers. This limits the registered connections to just HTTPS lookups. This must be run inside a Tokio runtime context.

pub fn quad9_tls() -> Self

Available on crate feature tokio and (crate features tls-aws-lc-rs or tls-ring) only.

Create a new TokioHickoryResolver that uses the Quad9 nameservers. This limits the registered connections to just TLS lookups. This must be run inside a Tokio runtime context.

pub fn with_config_and_options( config: ResolverConfig, options: ResolverOpts, ) -> Self

Available on crate feature tokio only.

Create a new TokioHickoryResolver with the resolver configuration options specified. This must be run inside a Tokio runtime context.

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

Available on crate features tokio and system-config only.

Create a new TokioHickoryResolver with the system configuration. This must be run inside a Tokio runtime context.

Errors

This method returns an error if loading the system configuration fails.

impl<C: ConnectionProvider> HickoryResolver<C>

pub fn from_resolver(resolver: Resolver<C>) -> Self

Create a HickoryResolver from the given Resolver.

pub fn into_http_connector(self) -> HickoryHttpConnector<C>

Create a new HickoryHttpConnector with this resolver.

Trait Implementations

impl<C: Clone + ConnectionProvider> Clone for HickoryResolver<C>

fn clone(&self) -> HickoryResolver<C>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<C: ConnectionProvider> Service<Name> for HickoryResolver<C>

type Response = SocketAddrs

Responses given by the service.

type Error = ResolveError

Errors produced by the service.

type Future = Pin<Box<dyn Future<Output = Result<<HickoryResolver<C> as Service<Name>>::Response, <HickoryResolver<C> 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.