compact3

javax.naming.ldap

Class LdapReferralException

java.lang.Object

java.lang.Throwable

java.lang.Exception

javax.naming.NamingException

javax.naming.ReferralException

javax.naming.ldap.LdapReferralException

All Implemented Interfaces:

Serializable

public abstract class LdapReferralException
extends ReferralException

这个抽象类是用来表示一个LDAP查询的例外。它延伸的基础 ReferralException提供 getReferralContext()接受请求的控制方法。ldapreferralexception是一个抽象类。它的具体实现决定了它的同步和序列化属性。

一个Control[]数组作为参数传递给方法的调用者拥有getReferralContext()。服务提供商不会修改数组或保持一个参考吧，尽管它可能保持引用数组中的单个Control对象。

从以下版本开始：

一点三

另请参见：

Serialized Form

Field Summary

Fields inherited from class javax.naming.NamingException

remainingName, resolvedName, resolvedObj, rootException

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	LdapReferralException() 构建一个新的实例ldapreferralexception。
protected	LdapReferralException(String explanation) 构建一个使用说明提供的ldapreferralexception新实例。

方法摘要

Modifier and Type	Method and Description
abstract Context	getReferralContext() 检索使用上下文环境和无控件继续使用该方法的上下文。
abstract Context	getReferralContext(Hashtable<?,?> env) 检索使用环境属性和没有控件的方法的上下文。
abstract Context	getReferralContext(Hashtable<?,?> env, Control[] reqCtls) 检索使用请求控件和环境属性继续使用的方法的上下文。

Methods inherited from class javax.naming.ReferralException

getReferralInfo, retryReferral, skipReferral

Methods inherited from class javax.naming.NamingException

appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause, toString, toString

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

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

Constructor Detail

LdapReferralException

protected LdapReferralException(String explanation)

构建一个使用说明提供的ldapreferralexception新实例。所有其他字段都设置为空。

参数

explanation -更多详细介绍这种例外。可以为空。

另请参见：

Throwable.getMessage()

LdapReferralException

protected LdapReferralException()

构建一个新的实例ldapreferralexception。所有字段都设置为空。

方法详细信息

getReferralContext

public abstract Context getReferralContext()
                                    throws NamingException

检索使用上下文环境和无控件继续使用该方法的上下文。推荐使用的上下文语境，把 ReferralException没有控制环境的性能。

此方法相当于

 getReferralContext(ctx.getEnvironment(), null);

哪里 ctx是语境，把 ReferralException.

正是在这一类中重写文件的目的只。看到ReferralException如何使用这种方法。

Specified by:

getReferralContext 方法重写，继承类 ReferralException

结果

继续该方法的非空上下文。

异常

NamingException -如果遇到一个命名的例外。调用 retryReferral()或 skipReferral()继续处理推荐。

getReferralContext

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

检索使用环境属性和没有控件的方法的上下文。推荐使用 env上下文的环境特性及无控件创建。

此方法相当于

 getReferralContext(env, null);

正是在这一类中重写文件的目的只。看到ReferralException如何使用这种方法。

Specified by:

getReferralContext 方法重写，继承类 ReferralException

参数

env -可能的空环境下使用检索查询上下文时。如果为空，没有环境属性将被使用。

结果

继续该方法的非空上下文。

异常

NamingException -如果遇到一个命名的例外。调用 retryReferral()或 skipReferral()继续处理推荐。

getReferralContext

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

检索使用请求控件和环境属性继续使用的方法的上下文。无论是否在上下文操作过程中直接遇到转介或间接地，例如在搜索枚举中，转介异常应提供一个继续操作的上下文。要继续操作，客户端程序应重新调用使用相同参数的方法，如原始调用。

reqCtls是当创建连接服务器使用的简称。这些控件将用于作为上下文上下文和上下文实例派生的上下文和上下文实例的连接请求控件。reqCtls也将语境的要求控制后续的上下文操作。详细内容见LdapContext类描述。

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

服务提供商的用户应该阅读实施细则LdapContext类描述的“服务提供者”部分。

参数

reqCtls -可能的空请求的控件使用的新语境。如果空或空数组意味着使用没有请求控制。

env -可能的空的环境属性时要使用的新语境。如果为空，则上下文初始化为没有环境属性。

结果

继续该方法的非空上下文。

异常

NamingException -如果遇到一个命名的例外。调用 retryReferral()或 skipReferral()继续处理推荐。