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, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, printStackTrace, printStackTrace, printStackTrace, setRemainingName, setResolvedName, setResolvedObj, setRootCause, toString, toString

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

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, 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)