java.lang.Object
javax.naming.ldap.spi.LdapDnsProvider
用于执行LDAP操作时进行DNS查找的服务提供程序类。
LDAP DNS提供程序是这个类的一个具体子类,具有零参数构造函数。LDAP DNS提供程序使用ServiceLoader工具来定位,如由InitialDirectContext指定。使用ServiceLoader
来创建和注册LdapDnsProvider
的实现。
LDAP DNS提供程序可用于环境中,其中默认的DNS解析机制不足以准确定位执行LDAP操作所需的正确LDAP服务器。例如,在包含ldap
和ldaps
服务器的环境中,您可能希望LdapContext仅查询ldaps
服务器。
- 自:
- 12
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionabstract Optional
<LdapDnsProviderResult> lookupEndpoints
(String url, Map<?, ?> env) 查找给定Context
provider URL
和环境的端点和域名。
-
Constructor Details
-
LdapDnsProvider
protected LdapDnsProvider()创建一个新的LdapDnsProvider
实例。- 抛出:
-
SecurityException
- 如果存在安全管理器并且其checkPermission
方法不允许RuntimePermission("ldapDnsProvider")
。
-
-
Method Details
-
lookupEndpoints
public abstract Optional<LdapDnsProviderResult> lookupEndpoints(String url, Map<?, ?> env) throws NamingException查找给定Context
provider URL
和环境的端点和域名。解析后的端点和域名作为LdapDnsProviderResult
返回。端点是指向用于LDAP操作的LDAP服务器的
String
表示形式。LDAP URL的语法由 RFC 2255: The LDAP URL Format定义。- 参数:
-
url
-Context
provider URL
-
env
-Context
环境。 - 返回:
-
一个
LdapDnsProviderResult
或空的Optional
(如果查找失败)。 - 抛出:
-
NamingException
- 如果url
无效或在执行查找时发生错误。 -
NullPointerException
- 如果url
或env
为null
。
-