compact3

javax.naming

Class ReferralException

java.lang.Object

java.lang.Throwable

java.lang.Exception

javax.naming.NamingException

javax.naming.ReferralException

All Implemented Interfaces:

Serializable

已知直接子类：

LdapReferralException

public abstract class ReferralException
extends NamingException

这个抽象类是用来表示一个转诊的例外，这是在回应一个转诊如LDAP V3服务器返回的产生。

服务提供商提供的ReferralException子类提供getReferralInfo()和getReferralContext()实现（和适当的构造函数和/或相应的“集合”的方法）。

下面的代码示例演示如何ReferralException可。

while (true) { try { bindings = ctx.listBindings(name); while (bindings.hasMore()) { b = bindings.next(); ... } break; } catch (ReferralException e) { ctx = e.getReferralContext(); } }

ReferralException是一个抽象类。具体实现确定其同步和序列化属性。

环境参数传递给getReferralContext()方法是由调用方拥有。服务提供程序不会修改对象或保持引用它，但可以保留它的一个克隆的参考。

从以下版本开始：

一点三

另请参见：

Serialized Form

Field Summary

Fields inherited from class javax.naming.NamingException

remainingName, resolvedName, resolvedObj, rootException

构造方法摘要

构造方法

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

方法摘要

Modifier and Type	Method and Description
abstract Context	getReferralContext() 检索继续该方法的上下文。
abstract Context	getReferralContext(Hashtable<?,?> env) 检索使用环境属性的方法的上下文。
abstract Object	getReferralInfo() 检索与此转介相关的信息（如网址）。
abstract void	retryReferral() 重试的推荐目前正在处理。
abstract boolean	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

ReferralException

protected ReferralException(String explanation)

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

参数

explanation -这个例外的附加细节。可以为空。

另请参见：

Throwable.getMessage()

ReferralException

protected ReferralException()

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

方法详细信息

getReferralInfo

public abstract Object getReferralInfo()

检索与此转介相关的信息（如网址）。该程序可以检查或显示此信息给用户，以确定是否继续与转介，或以确定需要提供额外的信息，以继续与转介。

结果

与此转介相关的非空转介信息。

getReferralContext

public abstract Context getReferralContext()
                                    throws NamingException

检索继续该方法的上下文。无论是否在上下文操作过程中直接遇到转介或间接地，例如在搜索枚举中，转介异常应提供一个继续操作的上下文。推荐使用的上下文语境，把referralexception环境特性创造。

要继续操作，客户端程序应重新调用使用相同参数的方法，如原始调用。

结果

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

异常

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

getReferralContext

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

检索使用环境属性的方法的上下文。无论是否在上下文操作过程中直接遇到转介或间接地，例如在搜索枚举中，转介异常应提供一个继续操作的上下文。

推荐使用env上下文的环境性能。这种方法可以用来代替无参数的重载形式当调用者需要使用不同的环境特性为介语境。它可能需要这样做，例如，当它需要向所提交的服务器提供不同的身份验证信息，以创建转介上下文。

要继续操作，客户端程序应重新调用使用相同参数的方法，如原始调用。

参数

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

结果

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

异常

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

skipReferral

public abstract boolean skipReferral()

丢弃的转诊要处理。调用此方法应遵循一个叫 getReferralContext让其他推荐的处理继续。下面的代码片段显示了一个典型的使用模式。

  } catch (ReferralException e) {
      if (!shallIFollow(e.getReferralInfo())) {
          if (!e.skipReferral()) {
              return;
          }
      }
      ctx = e.getReferralContext();
  }
 

结果

如果更多的转介处理挂起，则为假；否则为。

retryReferral

public abstract void retryReferral()

重试的推荐目前正在处理。调用此方法应遵循一个叫 getReferralContext允许电流转诊进行重审。下面的代码片段显示了一个典型的使用模式。

  } catch (ReferralException e) {
      while (true) {
          try {
              ctx = e.getReferralContext(env);
              break;
          } catch (NamingException ne) {
              if (! shallIRetry()) {
                  return;
              }
              // modify environment properties (env), if necessary
              e.retryReferral();
          }
      }
  }