Module java.naming

Package javax.naming.ldap.spi

Class LdapDnsProvider

java.lang.Object

javax.naming.ldap.spi.LdapDnsProvider

       public abstract class LdapDnsProvider extends Object
      

用于执行LDAP操作时进行DNS查找的服务提供程序类。

LDAP DNS提供程序是这个类的一个具体子类，具有零参数构造函数。LDAP DNS提供程序使用ServiceLoader工具来定位，如由InitialDirectContext指定。使用ServiceLoader来创建和注册LdapDnsProvider的实现。

LDAP DNS提供程序可用于环境中，其中默认的DNS解析机制不足以准确定位执行LDAP操作所需的正确LDAP服务器。例如，在包含ldap和ldaps服务器的环境中，您可能希望LdapContext仅查询ldaps服务器。

自：

12

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	LdapDnsProvider()	创建一个新的LdapDnsProvider实例。

Method Summary

Modifier and Type	Method	Description
abstract Optional<LdapDnsProviderResult>	lookupEndpoints(String url, Map<?,?> env)	查找给定Context provider URL和环境的端点和域名。

Methods declared in class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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。