org.jivesoftware.smack.util.dns

Class DNSResolver

java.lang.Object

org.jivesoftware.smack.util.dns.DNSResolver

Direct Known Subclasses:

DNSJavaResolver, JavaxResolver, MiniDnsResolver

public abstract class DNSResolver
extends java.lang.Object

Implementations of this interface define a class that is capable of resolving DNS addresses.

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.util.logging.Logger	LOGGER

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DNSResolver(boolean supportsDnssec)

Method Summary

Modifier and Type	Method and Description
HostAddress	lookupHostAddress(java.lang.String name, int port, java.util.List<HostAddress> failedAddresses, ConnectionConfiguration.DnssecMode dnssecMode)
protected java.util.List<java.net.InetAddress>	lookupHostAddress0(java.lang.String name, java.util.List<HostAddress> failedAddresses, ConnectionConfiguration.DnssecMode dnssecMode) Lookup the IP addresses of a given host name.
java.util.List<SRVRecord>	lookupSRVRecords(java.lang.String name, java.util.List<HostAddress> failedAddresses, ConnectionConfiguration.DnssecMode dnssecMode) Gets a list of service records for the specified service.
protected abstract java.util.List<SRVRecord>	lookupSRVRecords0(java.lang.String name, java.util.List<HostAddress> failedAddresses, ConnectionConfiguration.DnssecMode dnssecMode)
protected boolean	shouldContinue(java.lang.CharSequence name, java.lang.CharSequence hostname, java.util.List<java.net.InetAddress> hostAddresses)

Methods inherited from class java.lang.Object

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

Field Detail

LOGGER

protected static final java.util.logging.Logger LOGGER

Constructor Detail

DNSResolver

protected DNSResolver(boolean supportsDnssec)

Method Detail

lookupSRVRecords

public final java.util.List<SRVRecord> lookupSRVRecords(java.lang.String name,
                                                        java.util.List<HostAddress> failedAddresses,
                                                        ConnectionConfiguration.DnssecMode dnssecMode)

Gets a list of service records for the specified service.

Parameters:

name - The symbolic name of the service.

failedAddresses - list of failed addresses.

dnssecMode - security mode.

Returns:

The list of SRV records mapped to the service name.

lookupSRVRecords0

protected abstract java.util.List<SRVRecord> lookupSRVRecords0(java.lang.String name,
                                                               java.util.List<HostAddress> failedAddresses,
                                                               ConnectionConfiguration.DnssecMode dnssecMode)

lookupHostAddress

public final HostAddress lookupHostAddress(java.lang.String name,
                                           int port,
                                           java.util.List<HostAddress> failedAddresses,
                                           ConnectionConfiguration.DnssecMode dnssecMode)

lookupHostAddress0

protected java.util.List<java.net.InetAddress> lookupHostAddress0(java.lang.String name,
                                                                  java.util.List<HostAddress> failedAddresses,
                                                                  ConnectionConfiguration.DnssecMode dnssecMode)

Lookup the IP addresses of a given host name. Returns null if there was an error, in which the error reason will be added in form of a HostAddress to failedAddresses. Returns a empty list in case the DNS name exists but has no associated A or AAAA resource records. Otherwise, if the resolution was successful and there is at least one A or AAAA resource record, then a non-empty list will be returned.

Concrete DNS resolver implementations are free to overwrite this, but have to stick to the interface contract.

Parameters:

name - the DNS name to lookup

failedAddresses - a list with the failed addresses

dnssecMode - the selected DNSSEC mode

Returns:

A list, either empty or non-empty, or null

shouldContinue

protected final boolean shouldContinue(java.lang.CharSequence name,
                                       java.lang.CharSequence hostname,
                                       java.util.List<java.net.InetAddress> hostAddresses)