Smack

org.jivesoftware.smack.util
Class DNSUtil

java.lang.Object
  extended by org.jivesoftware.smack.util.DNSUtil

public class DNSUtil
extends Object

Utilty class to perform DNS lookups for XMPP services.

Author:
Matt Tucker

Nested Class Summary
static class DNSUtil.HostAddress
          Encapsulates a hostname and port.
 
Constructor Summary
DNSUtil()
           
 
Method Summary
static DNSUtil.HostAddress resolveXMPPDomain(String domain)
          Returns the host name and port that the specified XMPP server can be reached at for client-to-server communication.
static DNSUtil.HostAddress resolveXMPPServerDomain(String domain)
          Returns the host name and port that the specified XMPP server can be reached at for server-to-server communication.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DNSUtil

public DNSUtil()
Method Detail

resolveXMPPDomain

public static DNSUtil.HostAddress resolveXMPPDomain(String domain)
Returns the host name and port that 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 14.4 of RFC 3920. If that lookup fails, a lookup in the older form of "_jabber._tcp.example.com" is attempted since servers that implement an older version of the protocol may be listed using that notation. If that lookup fails as well, 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.
Returns:
a HostAddress, which encompasses the hostname and port that the XMPP server can be reached at for the specified domain.

resolveXMPPServerDomain

public static DNSUtil.HostAddress resolveXMPPServerDomain(String domain)
Returns the host name and port that 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 14.4 of RFC 3920. If that lookup fails, a lookup in the older form of "_jabber._tcp.example.com" is attempted since servers that implement an older version of the protocol may be listed using that notation. If that lookup fails as well, 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.
Returns:
a HostAddress, which encompasses the hostname and port that the XMPP server can be reached at for the specified domain.

Smack

Copyright © 2003-2007 Jive Software.