Module io.netty5.resolver.dns

Package io.netty5.resolver.dns

Class BiDnsQueryLifecycleObserver

java.lang.Object

io.netty5.resolver.dns.BiDnsQueryLifecycleObserver

All Implemented Interfaces:

DnsQueryLifecycleObserver

public final class BiDnsQueryLifecycleObserver
extends Object
implements DnsQueryLifecycleObserver

Combines two DnsQueryLifecycleObserver into a single DnsQueryLifecycleObserver.

Constructor Summary

Constructors

Constructor	Description
BiDnsQueryLifecycleObserver(DnsQueryLifecycleObserver a, DnsQueryLifecycleObserver b)	Create a new instance.

Method Summary

Modifier and Type	Method	Description
void	queryCancelled(int queriesRemaining)	The query may have been written but it was cancelled at some point.
DnsQueryLifecycleObserver	queryCNAMEd(DnsQuestion cnameQuestion)	The query returned a CNAME which we may attempt to follow with a new query.
void	queryFailed(Throwable cause)	The following criteria are possible: IO Error Server responded with an invalid DNS response Server responded with a valid DNS response, but it didn't progress the resolution
DnsQueryLifecycleObserver	queryNoAnswer(DnsResponseCode code)	The response to the query didn't provide the expected response code, but it didn't return DnsResponseCode.NXDOMAIN so we may try to query again.
DnsQueryLifecycleObserver	queryRedirected(List<InetSocketAddress> nameServers)	The query has been redirected to another list of DNS servers.
void	querySucceed()	The query received the expected results.
void	queryWritten(InetSocketAddress dnsServerAddress, Future<Void> future)	The query has been written.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BiDnsQueryLifecycleObserver

public BiDnsQueryLifecycleObserver(DnsQueryLifecycleObserver a,
                                   DnsQueryLifecycleObserver b)

Create a new instance.

Parameters:

a - The DnsQueryLifecycleObserver that will receive events first.

b - The DnsQueryLifecycleObserver that will receive events second.

Method Detail

queryWritten

public void queryWritten(InetSocketAddress dnsServerAddress,
                         Future<Void> future)

Description copied from interface: DnsQueryLifecycleObserver

The query has been written.

Specified by:

queryWritten in interface DnsQueryLifecycleObserver

Parameters:

dnsServerAddress - The DNS server address which the query was sent to.

future - The future which represents the status of the write operation for the DNS query.

queryCancelled

public void queryCancelled(int queriesRemaining)

Description copied from interface: DnsQueryLifecycleObserver

The query may have been written but it was cancelled at some point.

Specified by:

queryCancelled in interface DnsQueryLifecycleObserver

Parameters:

queriesRemaining - The number of queries remaining.

queryRedirected

public DnsQueryLifecycleObserver queryRedirected(List<InetSocketAddress> nameServers)

Description copied from interface: DnsQueryLifecycleObserver

The query has been redirected to another list of DNS servers.

Specified by:

queryRedirected in interface DnsQueryLifecycleObserver

Parameters:

nameServers - The name servers the query has been redirected to.

Returns:

An observer for the new query which we may issue.

queryCNAMEd

public DnsQueryLifecycleObserver queryCNAMEd(DnsQuestion cnameQuestion)

Description copied from interface: DnsQueryLifecycleObserver

The query returned a CNAME which we may attempt to follow with a new query.

Note that multiple queries may be encountering a CNAME. For example a if both DnsRecordType.AAAA and DnsRecordType.A are supported we may query for both.

Specified by:

queryCNAMEd in interface DnsQueryLifecycleObserver

Parameters:

cnameQuestion - the question we would use if we issue a new query.

Returns:

An observer for the new query which we may issue.

queryNoAnswer

public DnsQueryLifecycleObserver queryNoAnswer(DnsResponseCode code)

Description copied from interface: DnsQueryLifecycleObserver

The response to the query didn't provide the expected response code, but it didn't return DnsResponseCode.NXDOMAIN so we may try to query again.

Specified by:

queryNoAnswer in interface DnsQueryLifecycleObserver

Parameters:

code - the unexpected response code.

Returns:

An observer for the new query which we may issue.

queryFailed

public void queryFailed(Throwable cause)

Description copied from interface: DnsQueryLifecycleObserver

The following criteria are possible:

• IO Error
• Server responded with an invalid DNS response
• Server responded with a valid DNS response, but it didn't progress the resolution

Specified by:

queryFailed in interface DnsQueryLifecycleObserver

Parameters:

cause - The cause which for the failure.

querySucceed

public void querySucceed()

Description copied from interface: DnsQueryLifecycleObserver

The query received the expected results.

Specified by:

querySucceed in interface DnsQueryLifecycleObserver