クラスCannotProceedException

java.lang.Object
java.lang.Throwable
java.lang.Exception
javax.naming.NamingException
javax.naming.CannotProceedException
すべての実装されたインタフェース:
Serializable
public class CannotProceedException extends NamingException
この例外は、オペレーションをこれ以上進められない名前のポイントにオペレーションが達したことを示すためにスローされます。 合成名でオペレーションを実行すると、名前空間に属さない名前の部分にネーム・サービス・プロバイダが到達することがあります。 そのポイントではCannotProceedExceptionが構築され、javax.naming.spi.NamingManagerで提供されるメソッド(getContinuationContext()など)を呼び出して、オペレーションを続行する別のプロバイダが検索されます。 これを実行できない場合は、コンテキスト・オペレーションの呼出し側にこの例外が通知されます。

プログラムでこの例外を特別に処理する場合は、NamingExceptionをキャッチする前にCannotProceedExceptionを明示的にキャッチする必要があります。

CannotProceedExceptionインスタンスは、並行マルチスレッド・アクセスに対しては同期化されません。 複数のスレッドからCannotProceedExceptionにアクセスして変更する場合は、オブジェクトをロックする必要があります。

導入されたバージョン:
1.3
関連項目:

  • フィールドのサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    protected Name
    altName
    コンテキストaltNameCtxを基準にして解決されたオブジェクトの名前が含まれます。
    protected Context
    altNameCtx
    altNameが基準にして指定されているコンテキストが含まれます。
    protected Hashtable<?,?>
    environment
    処理を継続できないContextまたはDirContextメソッドに関連する環境を格納します。
    protected Name
    remainingNewName
    Context.rename()に対する2番目のname引数の残りの未解決部分が格納されます。

    クラスで宣言されたフィールド NamingException

    remainingName, resolvedName, resolvedObj, rootException
    修飾子と型
    フィールド
    説明
    protected Name
    remainingName
    未解決の残りの名前を含みます。
    protected Name
    resolvedName
    正常に解決された名前の部分を含みます。
    protected Object
    resolvedObj
    名前の部分が正常に解決されたオブジェクトを含みます。
    protected Throwable
    rootException
    このNamingExceptionがスローされる原因となった元の例外を含みます。

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

    コンストラクタ
    コンストラクタ
    説明
    CannotProceedException()
    CannotProceedExceptionの新しいインスタンスを構築します。
    CannotProceedException(String explanation)
    説明を使用して、CannotProceedExceptionの新しいインスタンスを構築します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    Name
    getAltName()
    この例外のaltNameフィールドを取得します。
    Context
    getAltNameCtx()
    この例外のaltNameCtxフィールドを取得します。
    Hashtable<?,?>
    getEnvironment()
    この例外が作成されたときに有効になった環境を取得します。
    Name
    getRemainingNewName()
    この例外の「remainingNewName (残存新規ネーム)」フィールドを取得します。このフィールドは、rename()オペレーションの際にこの例外がスローされた場合に使用されます。
    void
    setAltName(Name altName)
    この例外のaltNameフィールドを設定します。
    void
    setAltNameCtx(Context altNameCtx)
    この例外のaltNameCtxフィールドを設定します。
    void
    setEnvironment(Hashtable<?,?> environment)
    getEnvironment()が呼び出されたときに返される環境を設定します。
    void
    setRemainingNewName(Name newName)
    この例外の「remainingNewName (残存新規ネーム)」フィールドを設定します。

    クラスで宣言されたメソッド NamingException

    appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause, toString, toString
    修飾子と型
    メソッド
    説明
    void
    appendRemainingComponent(String name)
    残りの名前の最後のコンポーネントとして名前を追加します。
    void
    appendRemainingName(Name name)
    残りの名前の最後のコンポーネントとして「名前」からコンポーネントを追加します。
    Throwable
    getCause()
    この例外の原因を返します。
    String
    getExplanation()
    この例外に関連した説明を取得します。
    Name
    getRemainingName()
    名前の残りの未解決部分を取得します。
    Name
    getResolvedName()
    正常に解決された名前の先頭部分を取得します。
    Object
    getResolvedObj()
    正常に解決されたオブジェクトを取得します。
    Throwable
    getRootCause()
    このNamingExceptionの根本原因がある場合は、その根本原因を取得します。
    Throwable
    initCause(Throwable cause)
    この例外の原因を、指定された値に初期化します。
    void
    setRemainingName(Name name)
    この例外の残りの名前フィールドを設定します。
    void
    setResolvedName(Name name)
    この例外の「resolvedName」フィールドを設定します。
    void
    setResolvedObj(Object obj)
    この例外の「解決されたオブジェクト」フィールドを設定します。
    void
    setRootCause(Throwable e)
    このNamingExceptionの根本原因を記録します。
    String
    toString()
    この例外の文字列表現が生成されます。
    String
    toString(boolean detail)
    より詳細な文字列表現が生成されます。

    Throwableクラスで宣言されたメソッド

    addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace
    修飾子と型
    メソッド
    説明
    final void
    addSuppressed(Throwable exception)
    この例外を提供する目的で抑制された例外に、指定された例外を追加します。
    Throwable
    fillInStackTrace()
    実行スタック・トレースを埋め込みます。
    String
    getLocalizedMessage()
    このスロー可能オブジェクトの、ローカライズされた記述を作成します。
    String
    getMessage()
    このスロー可能オブジェクトの詳細メッセージ文字列を返します。
    StackTraceElement[]
    getStackTrace()
    Throwable.printStackTrace()によって出力されるスタック・トレース情報にプログラムでアクセスできるようにします。
    final Throwable[]
    getSuppressed()
    この例外を提供する目的で(通常try-with-resources文によって)抑制された例外をすべて含む配列を返します。
    void
    printStackTrace()
    このスロー可能オブジェクトおよびそのバックトレースを標準エラー・ストリームに出力します。
    void
    printStackTrace(PrintStream s)
    このスロー可能オブジェクトとそのバックトレースを指定された印刷ストリームに出力します。
    void
    printStackTrace(PrintWriter s)
    このスロー可能オブジェクトとそのバックトレースを指定されたプリント・ライターに出力します。
    void
    setStackTrace(StackTraceElement[] stackTrace)
    Throwable.getStackTrace()によって返され、Throwable.printStackTrace()と関連メソッドによって出力される、スタック・トレース要素を設定します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • フィールド詳細

    • remainingNewName

      protected Name remainingNewName
      Context.rename()に対する2番目のname引数の残りの未解決部分が格納されます。 この情報は、Context.rename()操作を続行するために必要です。

      このフィールドはnullに初期化されます。 直接操作しないでください。getRemainingName()とsetRemainingName()を使用してアクセスおよび更新される必要があります。

      関連項目:

    • environment

      protected Hashtable<?,?> environment
      処理を継続できないContextまたはDirContextメソッドに関連する環境を格納します。

      このフィールドはnullに初期化されます。 直接操作しないでください。getEnvironment()とsetEnvironment()を使用してアクセスおよび更新される必要があります。

      関連項目:

    • altName

      protected Name altName
      コンテキストaltNameCtxを基準にして解決されたオブジェクトの名前が含まれます。 合成名である。 nullの場合、名前は指定されない。 これの使用方法の詳細は、javax.naming.spi.ObjectFactory.getObjectInstanceメソッドを参照してください。

      このフィールドはnullに初期化されます。 直接操作しないでください。getAltName()とsetAltName()を使用してアクセスおよび更新される必要があります。

      関連項目:

    • altNameCtx

      protected Context altNameCtx
      altNameが基準にして指定されているコンテキストが含まれます。 nullの場合、デフォルトの初期コンテキストとなる。 これの使用方法の詳細は、javax.naming.spi.ObjectFactory.getObjectInstanceメソッドを参照してください。

      このフィールドはnullに初期化されます。 直接操作しないでください。getAltNameCtx()とsetAltNameCtx()を使用してアクセスおよび更新される必要があります。

      関連項目:

  • コンストラクタの詳細

    • CannotProceedException

      public CannotProceedException(String explanation)
      説明を使用して、CannotProceedExceptionの新しいインスタンスを構築します。 指定されていないフィールドはすべてデフォルトでnullになります。
      パラメータ:
      explanation - この例外に関する追加の詳細情報を含むnullの可能性がある文字列。 nullの場合、この例外には詳細メッセージはない。
      関連項目:

    • CannotProceedException

      public CannotProceedException()
      CannotProceedExceptionの新しいインスタンスを構築します。 フィールドのデフォルトはすべてnullになります。

  • メソッドの詳細

    • getEnvironment

      public Hashtable<?,?> getEnvironment()
      この例外が作成されたときに有効になった環境を取得します。
      戻り値:
      nullの可能性がある環境プロパティ・セット。nullは、この例外に対して環境が記録されていないことを示す。
      関連項目:

    • setEnvironment

      public void setEnvironment(Hashtable<?,?> environment)
      getEnvironment()が呼び出されたときに返される環境を設定します。
      パラメータ:
      environment - nullの可能性がある環境プロパティ・セットnullは、この例外に対して環境が記録されていないことを示す。
      関連項目:

    • getRemainingNewName

      public Name getRemainingNewName()
      この例外の「remainingNewName (残存新規ネーム)」フィールドを取得します。このフィールドは、rename()オペレーションの際にこの例外がスローされた場合に使用されます。
      戻り値:
      解決されていない新しい名前の、nullの可能性がある部分。 合成名である。 nullの場合は、「remainingNewName (残存新規ネーム)」フィールドが設定されていないことを示す。
      関連項目:

    • setRemainingNewName

      public void setRemainingNewName(Name newName)
      この例外の「remainingNewName (残存新規ネーム)」フィールドを設定します。 これは、getRemainingNewName()で返される値です。

      newNameはコンポジット名です。 複合名または文字列を使用してこのフィールドを設定する場合は、複合名を文字列化してから、その文字列を使用して単一のコンポーネントを含む合成名を作成する必要があります。 その結果示された合成名を使用して、このメソッドを呼び出すことができます。

      newNameのコピーが作成され、格納されます。 以降のnameへの変更はこのNamingException内のコピーに影響を与えず、その逆も同様です。

      パラメータ:
      newName -「remainingNewName (残存新規ネーム)」が設定される、nullの可能性がある名前。 nullの場合、残りの名前フィールドはnullに設定される。
      関連項目:

    • getAltName

      public Name getAltName()
      この例外のaltNameフィールドを取得します。 これは、コンテキストaltNameCtxに関連した、解決されたオブジェクトの名前です。 javax.naming.spi.ObjectFactory.getObjectInstanceメソッドの以降の呼出し中に使用されます。
      戻り値:
      altNameCtxに関連した解決されたオブジェクトの名前。 合成名である。 nullの場合、名前は指定されない。
      関連項目:

    • setAltName

      public void setAltName(Name altName)
      この例外のaltNameフィールドを設定します。
      パラメータ:
      altName - altNameCtxに関連した解決されたオブジェクトの名前。 合成名である。 nullの場合、名前は指定されない。
      関連項目:

    • getAltNameCtx

      public Context getAltNameCtx()
      この例外のaltNameCtxフィールドを取得します。 これは、altNameの命名に関連したコンテキストです。 javax.naming.spi.ObjectFactory.getObjectInstanceメソッドの以降の呼出し中に使用されます。
      戻り値:
      altNameの命名に関連したコンテキスト。 nullの場合、デフォルトの初期コンテキストとなる。
      関連項目:

    • setAltNameCtx

      public void setAltNameCtx(Context altNameCtx)
      この例外のaltNameCtxフィールドを設定します。
      パラメータ:
      altNameCtx - altNameの命名に関連したコンテキスト。 nullの場合、デフォルトの初期コンテキストとなる。
      関連項目: