org.nuxeo.ecm.directory.ldap.dns
Interface DNSServiceResolver

All Known Implementing Classes:

DNSServiceResolverImpl

public interface DNSServiceResolver

Utility to fetch SRV records from a DNS server to get the list of available ldap servers from the DN representation of the domain.

See: http://en.wikipedia.org/wiki/SRV_record

Author:

Robert Browning

Field Summary

static java.lang.String	DNS_CACHE_EXPIRY DNS Cache Expiry property
static java.lang.String	LDAP_SERVICE_PREFIX Prefix to locate LDAP service on DNS Server.

Method Summary

java.util.List<DNSServiceEntry>	resolveLDAPDomainServers(java.lang.String domain) Returns a list of LDAP servers for the specified domain by performing an SRV DNS lookup on _ldap.
java.util.List<DNSServiceEntry>	resolveLDAPDomainServers(java.lang.String domain, java.lang.String prefix) Returns a list of LDAP servers for the specified domain by performing an SRV DNS lookup using a custom DNS service prefix.

Field Detail

DNS_CACHE_EXPIRY

static final java.lang.String DNS_CACHE_EXPIRY

DNS Cache Expiry property

See Also:

Constant Field Values

LDAP_SERVICE_PREFIX

static final java.lang.String LDAP_SERVICE_PREFIX

Prefix to locate LDAP service on DNS Server.

service: _ldap
protocol: _tcp

See Also:

Constant Field Values

Method Detail

resolveLDAPDomainServers

java.util.List<DNSServiceEntry> resolveLDAPDomainServers(java.lang.String domain)
                                                         throws javax.naming.NamingException

Returns a list of LDAP servers for the specified domain by performing an SRV DNS lookup on _ldap._tcp.${domain}.

Parameters:

domain -

Returns:

the list of SRV dns entries

Throws:

javax.naming.NamingException

resolveLDAPDomainServers

java.util.List<DNSServiceEntry> resolveLDAPDomainServers(java.lang.String domain,
                                                         java.lang.String prefix)
                                                         throws javax.naming.NamingException

Returns a list of LDAP servers for the specified domain by performing an SRV DNS lookup using a custom DNS service prefix.

Parameters:

domain -

prefix - custom SRV prefix such as "_gc._tcp"

Returns:

the list of SRV dns entries

Throws:

javax.naming.NamingException