モジュール java.naming
パッケージ javax.naming.ldap

クラスLdapReferralException

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

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

        定義:
        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()のどちらかを呼び出して、参照の処理を継続する。