DnsServerResponseFeedbackAddressStream Type — netty Architecture

Source Code

resolver-dns/src/main/java/io/netty/resolver/dns/DnsServerResponseFeedbackAddressStream.java lines 25–47

public interface DnsServerResponseFeedbackAddressStream extends DnsServerAddressStream {

    /**
     * A way to provide success feedback to {@link DnsServerAddressStream} so that {@link #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
     *
     * @param address The address returned by {@link #next()} that feedback needs to be applied to
     * @param queryResponseTimeNanos The response time of a query against the given DNS server
     */
    void feedbackSuccess(InetSocketAddress address, long queryResponseTimeNanos);

    /**
     * A way to provide failure feedback to {@link DnsServerAddressStream} so that {@link #next()} cab be tuned
     * to return the best performing DNS server address
     *
     * @param address The address returned by {@link #next()} that feedback needs to be applied to
     * @param failureCause The reason the DNS query failed, can be used to penalize failures differently
     * @param queryResponseTimeNanos The response time of a query against the given DNS server
     */
    void feedbackFailure(InetSocketAddress address, Throwable failureCause, long queryResponseTimeNanos);
}