Struct hickory_proto::xfer::retry_dns_handle::RetryDnsHandle

pub struct RetryDnsHandle<H>
where
    H: DnsHandle + Unpin + Send,
    H::Error: RetryableError,
{ /* private fields */ }

Can be used to reattempt queries if they fail

Note: this does not reattempt queries that fail with a negative response. For example, if a query gets a NODATA response from a name server, the query will not be retried. It only reattempts queries that effectively failed to get a response, such as queries that resulted in IO or timeout errors.

Whether an error is retryable by the RetryDnsHandle is determined by the RetryableError trait.

note Current value of this is not clear, it may be removed

Implementations

impl<H> RetryDnsHandle<H>

where H: DnsHandle + Unpin + Send, H::Error: RetryableError,

pub fn new(handle: H, attempts: usize) -> Self

Creates a new Client handler for reattempting requests on failures.

Arguments

• handle - handle to the dns connection
• attempts - number of attempts before failing

Trait Implementations

impl<H> Clone for RetryDnsHandle<H>

where H: DnsHandle + Unpin + Send + Clone, H::Error: RetryableError,

fn clone(&self) -> RetryDnsHandle<H>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<H> DnsHandle for RetryDnsHandle<H>

where H: DnsHandle + Send + Unpin + 'static, H::Error: RetryableError,

type Response = Pin<Box<dyn Stream<Item = Result<DnsResponse, <RetryDnsHandle<H> as DnsHandle>::Error>> + Unpin + Send>>

The associated response from the response stream, this should resolve to the Response messages

type Error = <H as DnsHandle>::Error

Error of the response, generally this will be ProtoError

fn send<R: Into<DnsRequest>>(&self, request: R) -> Self::Response

Send a message via the channel in the client

fn is_verifying_dnssec(&self) -> bool

Only returns true if and only if this DNS handle is validating DNSSEC.

fn is_using_edns(&self) -> bool

Allow for disabling EDNS

fn lookup(&self, query: Query, options: DnsRequestOptions) -> Self::Response

A classic DNS query