compact3

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

このabstractクラスは、LDAP参照例外を表すために使用されます。要求コントロールを受け取るgetReferralContext()メソッドに対応して、基底となるReferralExceptionを拡張します。LdapReferralExceptionは、abstractクラスです。この具象実装によって、そのクラスの同期および直列化プロパティが決定します。

getReferralContext()メソッドにパラメータとして渡されるControl[]配列は、呼出し側が所有します。サービス・プロバイダは配列を変更したり、その参照を保持したりはしませんが、配列内の個々のControlオブジェクトへの参照を保持する可能性があります。

導入されたバージョン:

1.3

関連項目:

直列化された形式

フィールドのサマリー

クラス javax.naming.NamingExceptionから継承されたフィールド

remainingName, resolvedName, resolvedObj, rootException

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタと説明
protected	LdapReferralException() LdapReferralExceptionのインスタンスを新しく構築します。
protected	LdapReferralException(String explanation) 指定された説明を使用して、LdapReferralExceptionのインスタンスを新たに構築します。

メソッドのサマリー

修飾子と型	メソッドと説明
abstract Context	getReferralContext() コントロールは使わずに、コンテキストの環境を使用してメソッドを継続する時点のコンテキストを検出します。
abstract Context	getReferralContext(Hashtable<?,?> env) コントロールは使用せずに、環境プロパティを使用してメソッドを継続する時点のコンテキストを検出します。
abstract Context	getReferralContext(Hashtable<?,?> env, Control[] reqCtls) 要求コントロールおよび環境プロパティを使用して、メソッドを継続する時点のコンテキストを取り出します。

クラス javax.naming.ReferralExceptionから継承されたメソッド

getReferralInfo, retryReferral, skipReferral

クラス javax.naming.NamingExceptionから継承されたメソッド

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

クラス java.lang.Throwableから継承されたメソッド

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

クラス java.lang.Objectから継承されたメソッド

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

コンストラクタの詳細

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を参照してください。

定義:

getReferralContext、クラス: ReferralException

戻り値:

メソッドを継続する時点のnull以外のコンテキスト。

例外:

NamingException - ネーミング例外が検出された場合。retryReferral()またはskipReferral()のどちらかを呼び出して、参照の処理を継続する。

getReferralContext

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

コントロールは使用せずに、環境プロパティを使用してメソッドを継続する時点のコンテキストを検出します。参照コンテキストは、envを環境プロパティとして使用し、コントロールを使用せずに作成されます。

このメソッドは、次と同等です。

 getReferralContext(env, null);

このメソッドは、ドキュメントを目的とした場合に限り、このクラスでオーバーライドされます。このメソッドの使用方法については、ReferralExceptionを参照してください。

定義:

getReferralContext、クラス: ReferralException

パラメータ:

env - 参照コンテキストを取得するときに使用するnullの可能性がある環境。nullの場合は、環境プロパティは使用されない。

戻り値:

メソッドを継続する時点のnull以外のコンテキスト。

例外:

NamingException - ネーミング例外が検出された場合。retryReferral()またはskipReferral()のどちらかを呼び出して、参照の処理を継続する。

getReferralContext

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

要求コントロールおよび環境プロパティを使用して、メソッドを継続する時点のコンテキストを取り出します。参照の発生が、コンテキストの操作中直接であっても、検索列挙中など間接的であっても、参照例外は操作を継続する時点のコンテキストを提供します。操作を継続するには、クライアント・プログラムで、元の呼び出しと同じ引数を使用するメソッドを再度呼び出します。

参照元サーバーに接続するときは、reqCtlsが使用されます。このようなコントロールは、コンテキスト、およびそのコンテキストから派生したコンテキスト・インスタンスに対する接続要求コントロールとして使用されます。reqCtlsは、後続のコンテキスト操作の要求コントロールとしても使われます。詳細は、LdapContextクラスの説明を参照してください。

呼出し側が参照コンテキスト作成のために要求コントロールを指定する必要があるときは、オーバーロードされたほかの2つの形式ではなく、このメソッドを使用します。認証に関する特定のコントロールを指定しなければならない場合などに使用します。

サービス・プロバイダの実装者は、実装の詳細について、LdapContextのクラスの説明にある「サービス・プロバイダ」のセクションを参照するようにしてください。

パラメータ:

reqCtls - 新しいコンテキストに使用するnullの可能性がある要求コントロール。nullまたは空の配列の場合は、要求コントロールを使用していないことを示す。

env - 新しいコンテキストの場合に使用するnullの可能性がある環境プロパティ。nullの場合は、コンテキストが環境プロパティを使って初期化されていない。

戻り値:

メソッドを継続する時点のnull以外のコンテキスト。

例外:

NamingException - ネーミング例外が検出された場合。retryReferral()またはskipReferral()のどちらかを呼び出して、参照の処理を継続する。