public abstract class LdapDnsProvider extends Object
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.
Modifier | Constructor | Description |
---|---|---|
protected |
Creates a new instance of LdapDnsProvider . |
Modifier and Type | Method | Description |
---|---|---|
abstract Optional |
lookupEndpoints |
Lookup the endpoints and domain name for the given Context provider URL and environment. |
protected LdapDnsProvider()
LdapDnsProvider
.SecurityException
- if a security manager is present and its checkPermission
method doesn't allow the RuntimePermission("ldapDnsProvider")
.public abstract Optional<LdapDnsProviderResult> lookupEndpoints(String url, Map<?,?> env) throws NamingException
Context
provider URL
and environment. The resolved endpoints and domain name are returned as an LdapDnsProviderResult
. An endpoint is a String
representation 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.
url
- The Context
provider URL
env
- The Context
environment.LdapDnsProviderResult
or empty Optional
if the lookup fails.NamingException
- if the url
is not valid or an error occurred while performing the lookup.NullPointerException
- if either url
or env
are null
.
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.naming/javax/naming/ldap/spi/LdapDnsProvider.html