JavaTM Platform
Standard Ed. 6

javax.naming
クラス 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 引数の残りの未解決部分が格納されます。
 
クラス javax.naming.NamingException から継承されたフィールド
remainingName, resolvedName, resolvedObj, rootException
 
コンストラクタの概要
CannotProceedException()
          CannotProceedException の新しいインスタンスを構築します。
CannotProceedException(String explanation)
          説明を使用して、CannotProceedException の新しいインスタンスを構築します。
 
メソッドの概要
 Name getAltName()
          この例外の altName フィールドを取得します。
 Context getAltNameCtx()
          この例外の altNameCtx フィールドを取得します。
 Hashtable<?,?> getEnvironment()
          この例外が作成されたときに有効になった環境を取得します。
 Name getRemainingNewName()
          この例外の [remainingNewName (残存新規ネーム)] フィールドを取得します。
 void setAltName(Name altName)
          この例外の altName フィールドを設定します。
 void setAltNameCtx(Context altNameCtx)
          この例外の altNameCtx フィールドを設定します。
 void setEnvironment(Hashtable<?,?> environment)
          getEnvironment() が呼び出されたときに返される環境を設定します。
 void setRemainingNewName(Name newName)
          この例外の [remainingNewName (残存新規ネーム)] フィールドを設定します。
 
クラス javax.naming.NamingException から継承されたメソッド
appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause, toString, toString
 
クラス java.lang.Throwable から継承されたメソッド
fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, printStackTrace, printStackTrace, printStackTrace, setStackTrace
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

remainingNewName

protected Name remainingNewName
Context.rename() に対する 2 番目の name 引数の残りの未解決部分が格納されます。この情報は、Context.rename() オペレーションの続行に必要です。

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

関連項目:
getRemainingNewName(), setRemainingNewName(javax.naming.Name)

environment

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

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

関連項目:
getEnvironment(), setEnvironment(java.util.Hashtable)

altName

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

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

関連項目:
getAltName(), setAltName(javax.naming.Name), altNameCtx, ObjectFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable)

altNameCtx

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

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

関連項目:
getAltNameCtx(), setAltNameCtx(javax.naming.Context), altName, ObjectFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable)
コンストラクタの詳細

CannotProceedException

public CannotProceedException(String explanation)
説明を使用して、CannotProceedException の新しいインスタンスを構築します。指定されていないフィールドはすべてデフォルトで null になります。

パラメータ:
explanation - null の可能性がある、この例外に関する追加の詳細情報を含んだ文字列null の場合、この例外には詳細メッセージはない
関連項目:
Throwable.getMessage()

CannotProceedException

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

メソッドの詳細

getEnvironment

public Hashtable<?,?> getEnvironment()
この例外が作成されたときに有効になった環境を取得します。

戻り値:
null の可能性がある環境プロパティーセット。null は、この例外に対して環境が記録されていないことを示す
関連項目:
setEnvironment(java.util.Hashtable)

setEnvironment

public void setEnvironment(Hashtable<?,?> environment)
getEnvironment() が呼び出されたときに返される環境を設定します。

パラメータ:
environment - null の可能性がある環境プロパティーセット null は、この例外に対して環境が記録されていないことを示す
関連項目:
getEnvironment()

getRemainingNewName

public Name getRemainingNewName()
この例外の [remainingNewName (残存新規ネーム)] フィールドを取得します。このフィールドは、rename() オペレーションの際にこの例外がスローされた場合に使用されます。

戻り値:
解決されていない新しい名前の、null の可能性がある部分。合成名である。null の場合は、[remainingNewName (残存新規ネーム)] フィールドが設定されていないことを示す
関連項目:
setRemainingNewName(javax.naming.Name)

setRemainingNewName

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

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

newName のコピーが作成され、格納されます。その後 name を変更してもこの NamingException のコピーには影響せず、逆の場合も同じです。

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

getAltName

public Name getAltName()
この例外の altName フィールドを取得します。これは、コンテキスト altNameCtx に関連した、解決されたオブジェクトの名前です。そのあと、javax.naming.spi.ObjectFactory.getObjectInstance メソッドを呼び出すときに使用されます。

戻り値:
altNameCtx に関連した解決されたオブジェクトの名前。合成名である。null の場合、名前は指定されない
関連項目:
setAltName(javax.naming.Name), getAltNameCtx(), ObjectFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable)

setAltName

public void setAltName(Name altName)
この例外の altName フィールドを設定します。

パラメータ:
altName - altNameCtx に関連した解決されたオブジェクトの名前。合成名である。null の場合、名前は指定されない
関連項目:
getAltName(), setAltNameCtx(javax.naming.Context)

getAltNameCtx

public Context getAltNameCtx()
この例外の altNameCtx フィールドを取得します。これは、altName の命名に関連したコンテキストです。そのあと、javax.naming.spi.ObjectFactory.getObjectInstance メソッドを呼び出すときに使用されます。

戻り値:
altName の命名に関連したコンテキスト。null の場合、デフォルトの初期コンテキストとなる
関連項目:
setAltNameCtx(javax.naming.Context), getAltName(), ObjectFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable)

setAltNameCtx

public void setAltNameCtx(Context altNameCtx)
この例外の altNameCtx フィールドを設定します。

パラメータ:
altNameCtx - altName の命名に関連したコンテキスト。null の場合、デフォルトの初期コンテキストとなる
関連項目:
getAltNameCtx(), setAltName(javax.naming.Name)

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。