org.jivesoftware.smack.util

Class DNSUtil

java.lang.Object

org.jivesoftware.smack.util.DNSUtil

public class DNSUtil
extends java.lang.Object

Utility class to perform DNS lookups for XMPP services.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	XMPP_CLIENT_DNS_SRV_PREFIX
static java.lang.String	XMPP_SERVER_DNS_SRV_PREFIX

Constructor Summary

Constructors

Constructor and Description
DNSUtil()

Method Summary

Modifier and Type	Method and Description
static SmackDaneProvider	getDaneProvider() Returns the currently active DANE provider used when DANE is enabled.
static DNSResolver	getDNSResolver() Returns the current DNS resolved used to perform DNS lookups.
static java.util.List<HostAddress>	resolveXMPPServerDomain(org.minidns.dnsname.DnsName domain, java.util.List<HostAddress> failedAddresses, ConnectionConfiguration.DnssecMode dnssecMode) Returns a list of HostAddresses under which the specified XMPP server can be reached at for server-to-server communication.
static java.util.List<HostAddress>	resolveXMPPServiceDomain(org.minidns.dnsname.DnsName domain, java.util.List<HostAddress> failedAddresses, ConnectionConfiguration.DnssecMode dnssecMode) Returns a list of HostAddresses under which the specified XMPP server can be reached at for client-to-server communication.
static void	setDaneProvider(SmackDaneProvider daneProvider) Set the DANE provider that should be used when DANE is enabled.
static void	setDNSResolver(DNSResolver resolver) Set the DNS resolver that should be used to perform DNS lookups.

Methods inherited from class java.lang.Object

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

Field Detail

XMPP_CLIENT_DNS_SRV_PREFIX

public static final java.lang.String XMPP_CLIENT_DNS_SRV_PREFIX

See Also:

Constant Field Values

XMPP_SERVER_DNS_SRV_PREFIX

public static final java.lang.String XMPP_SERVER_DNS_SRV_PREFIX

See Also:

Constant Field Values

Constructor Detail

DNSUtil

public DNSUtil()

Method Detail

setDNSResolver

public static void setDNSResolver(DNSResolver resolver)

Set the DNS resolver that should be used to perform DNS lookups.

Parameters:

resolver -

getDNSResolver

public static DNSResolver getDNSResolver()

Returns the current DNS resolved used to perform DNS lookups.

Returns:

the active DNSResolver

setDaneProvider

public static void setDaneProvider(SmackDaneProvider daneProvider)

Set the DANE provider that should be used when DANE is enabled.

Parameters:

daneProvider -

getDaneProvider

public static SmackDaneProvider getDaneProvider()

Returns the currently active DANE provider used when DANE is enabled.

Returns:

the active DANE provider

resolveXMPPServiceDomain

public static java.util.List<HostAddress> resolveXMPPServiceDomain(org.minidns.dnsname.DnsName domain,
                                                                   java.util.List<HostAddress> failedAddresses,
                                                                   ConnectionConfiguration.DnssecMode dnssecMode)

Returns a list of HostAddresses under which the specified XMPP server can be reached at for client-to-server communication. A DNS lookup for a SRV record in the form "_xmpp-client._tcp.example.com" is attempted, according to section 3.2.1 of RFC 6120. If that lookup fails, it's assumed that the XMPP server lives at the host resolved by a DNS lookup at the specified domain on the default port of 5222.

As an example, a lookup for "example.com" may return "im.example.com:5269".

Parameters:

domain - the domain.

failedAddresses - on optional list that will be populated with host addresses that failed to resolve.

dnssecMode - DNSSec mode.

Returns:

List of HostAddress, which encompasses the hostname and port that the XMPP server can be reached at for the specified domain.

resolveXMPPServerDomain

public static java.util.List<HostAddress> resolveXMPPServerDomain(org.minidns.dnsname.DnsName domain,
                                                                  java.util.List<HostAddress> failedAddresses,
                                                                  ConnectionConfiguration.DnssecMode dnssecMode)

Returns a list of HostAddresses under which the specified XMPP server can be reached at for server-to-server communication. A DNS lookup for a SRV record in the form "_xmpp-server._tcp.example.com" is attempted, according to section 3.2.1 of RFC 6120. If that lookup fails , it's assumed that the XMPP server lives at the host resolved by a DNS lookup at the specified domain on the default port of 5269.

As an example, a lookup for "example.com" may return "im.example.com:5269".

Parameters:

domain - the domain.

failedAddresses - on optional list that will be populated with host addresses that failed to resolve.

dnssecMode - DNSSec mode.

Returns:

List of HostAddress, which encompasses the hostname and port that the XMPP server can be reached at for the specified domain.