Java javax.naming.ldap 类 LdapReferralException（JDK5）

所有类

javax.naming.ldap
类 LdapReferralException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          javax.naming.NamingException
              javax.naming.ReferralException
                  javax.naming.ldap.LdapReferralException

所有已实现的接口：

Serializable

public abstract class LdapReferralException
   
   
   
   
   
extends ReferralException
   
   
   
   
   

此抽象类用于表示 LDAP 反向链接 (referral) 异常。它通过提供接受请求控件的 getReferralContext() 方法扩展基础 ReferralException。LdapReferralException 是一个抽象类。它具体的实现确定其同步和序列化属性。

作为参数传递给 getReferralContext() 方法的 Control[] 数组为调用方所有。服务提供程序将不修改数组，也不保持对它的引用，但它可能保持对数组中个别 Control 对象的引用。

从以下版本开始：

1.3

另请参见：

序列化表格

LdapReferralException

protected LdapReferralException(String explanation)

使用所提供的解释构造一个新的 LdapReferralException 实例。将所有其他字段都设置为 null。

参数：

explanation - 有关此异常的附加详细信息。可以为 null。

另请参见：

Throwable.getMessage()

LdapReferralException

protected LdapReferralException()

构造一个新的 LdapReferralException 实例。将所有字段都设置为 null。

getReferralContext

public abstract Context getReferralContext()
                                    throws NamingException

使用上下文的环境（但不使用控件）检索继续该方法的上下文。使用抛出 ReferralException 的上下文的环境属性（但不使用控件）创建反向链接上下文。

该方法等效于

 getReferralContext(ctx.getEnvironment(), null);

其中 ctx 是抛出 ReferralException. 的上下文

在此类中重写该方法仅出于文档编制目的。有关使用此方法的方式，请参阅 ReferralException。

指定者：

类 ReferralException 中的 getReferralContext

返回：

将继续该方法的非 null 上下文。

抛出：

NamingException - 如果遇到命名异常。调用 retryReferral() 或 skipReferral() 来继续处理这些反向链接。

getReferralContext

public abstract Context getReferralContext(Hashtable<?,?> env)
                                    throws NamingException

使用环境属性（但不使用控件）检索继续该方法的上下文。使用 env 作为其环境属性（但不使用控件）创建反向链接上下文。

该方法等效于

 getReferralContext(env, null);

在此类中重写该方法仅出于文档编制目的。有关使用此方法的方式，请参阅 ReferralException。

指定者：

类 ReferralException 中的 getReferralContext

参数：

env - 检索反向链接上下文时要使用的环境（可能为 null）。如果为 null，则不使用环境属性。

返回：

将继续该方法的非 null 上下文。

抛出：

NamingException - 如果遇到命名异常。调用 retryReferral() 或 skipReferral() 来继续处理这些反向链接。

getReferralContext

public abstract Context getReferralContext(Hashtable<?,?> env,
                                           Control[] reqCtls)
                                    throws NamingException

使用请求控件和环境属性检索继续该方法的上下文。不管在上下文操作期间（例如在搜索枚举期间）是否直接或间接地遇到某一反向链接，反向链接异常都应该提供一个继续该操作的上下文。要继续该操作，客户端程序应该使用与初始调用相同的参数重新调用该方法。

reqCtls 在创建到反向链接的服务器的连接时使用。这些控件将用作上下文和从上下文派生的上下文实例的连接请求控件。reqCtls 同时还是后续上下文操作的上下文请求控件。有关详细信息，请参阅 LdapContext 类描述。

当调用方需要提供请求控件来创建反向链接上下文时，应该使用此方法，而不是其他两个重载形式。例如，当需要提供与身份验证有关的特殊控件时，它可能这样做。

服务提供程序的实现方应该参阅 LdapContext 类描述中的 "Service Provider" 一节，以获取实现的详细信息。

参数：

reqCtls - 要用于新上下文的请求控件（可能为 null）。如果 null 或空数组意味着不使用任何请求控件。

env - 要用于新上下文的环境属性（可能为 null）。如果为 null，则不使用任何环境属性初始化上下文。

返回：

将继续该方法的非 null 上下文。

抛出：

NamingException - 如果遇到命名异常。调用 retryReferral() 或 skipReferral() 来继续处理这些反向链接。