Class LdapDnsProvider
 An LDAP DNS provider is a concrete subclass of this class that
 has a zero-argument constructor. LDAP DNS providers are located using the
 ServiceLoader facility, as specified by
 InitialDirectContext.
 The
 ServiceLoader is used to create and register
 implementations of LdapDnsProvider.
 
 An LDAP DNS provider can be used in environments where the default
 DNS resolution mechanism is not sufficient to accurately pinpoint the
 correct LDAP servers needed to perform LDAP operations. For example, in an
 environment containing a mix of ldap and ldaps servers
 you may want the LdapContext
 to query ldaps servers only.
- Since:
- 12
- 
Constructor SummaryConstructorsModifierConstructorDescriptionprotectedCreates a new instance ofLdapDnsProvider.
- 
Method SummaryModifier and TypeMethodDescriptionabstract Optional<LdapDnsProviderResult> lookupEndpoints(String url, Map<?, ?> env) Lookup the endpoints and domain name for the givenContextprovider URLand environment.
- 
Constructor Details- 
LdapDnsProviderprotected LdapDnsProvider()Creates a new instance ofLdapDnsProvider.
 
- 
- 
Method Details- 
lookupEndpointspublic abstract Optional<LdapDnsProviderResult> lookupEndpoints(String url, Map<?, ?> env) throws NamingExceptionLookup the endpoints and domain name for the givenContextprovider URLand environment. The resolved endpoints and domain name are returned as anLdapDnsProviderResult.An endpoint is a Stringrepresentation of an LDAP URL which points to an LDAP server to be used for LDAP operations. The syntax of an LDAP URL is defined by RFC 2255: The LDAP URL Format.- Parameters:
- url- The- Context- provider URL
- env- The- Contextenvironment.
- Returns:
- an LdapDnsProviderResultor emptyOptionalif the lookup fails.
- Throws:
- NamingException- if the- urlis not valid or an error occurred while performing the lookup.
- NullPointerException- if either- urlor- envare- null.
 
 
-