Interface DnsServerResponseFeedbackAddressStream

All Superinterfaces:

DnsServerAddressStream

public interface DnsServerResponseFeedbackAddressStream
extends DnsServerAddressStream

An infinite stream of DNS server addresses, that requests feedback to be returned to it. If query is successful timing information is provided, else a failure notification is given.

Method Summary

Modifier and Type	Method	Description
void	feedbackFailure(InetSocketAddress address, Throwable failureCause, long queryResponseTimeNanos)	A way to provide failure feedback to DnsServerAddressStream so that DnsServerAddressStream.next() cab be tuned to return the best performing DNS server address
void	feedbackSuccess(InetSocketAddress address, long queryResponseTimeNanos)	A way to provide success feedback to DnsServerAddressStream so that DnsServerAddressStream.next() can be tuned to return the best performing DNS server address NOTE: This is called regardless of the RCode returned by the DNS server

Methods inherited from interface DnsServerAddressStream

duplicate, next, size

Modifier and Type	Method	Description
DnsServerAddressStream	duplicate()	Duplicate this object.
InetSocketAddress	next()	Retrieves the next DNS server address from the stream.
int	size()	Get the number of times DnsServerAddressStream.next() will return a distinct element before repeating or terminating.

Method Details

feedbackSuccess

void feedbackSuccess(InetSocketAddress address,
 long queryResponseTimeNanos)

A way to provide success feedback to DnsServerAddressStream so that DnsServerAddressStream.next() can be tuned to return the best performing DNS server address NOTE: This is called regardless of the RCode returned by the DNS server

Parameters:

address - The address returned by DnsServerAddressStream.next() that feedback needs to be applied to

queryResponseTimeNanos - The response time of a query against the given DNS server

feedbackFailure

void feedbackFailure(InetSocketAddress address,
 Throwable failureCause,
 long queryResponseTimeNanos)

A way to provide failure feedback to DnsServerAddressStream so that DnsServerAddressStream.next() cab be tuned to return the best performing DNS server address

Parameters:

address - The address returned by DnsServerAddressStream.next() that feedback needs to be applied to

failureCause - The reason the DNS query failed, can be used to penalize failures differently

queryResponseTimeNanos - The response time of a query against the given DNS server