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 (残存新規ネーム)] フィールドを取得します。このフィールドは、rename() オペレーションの際にこの例外がスローされた場合に使用されます。
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 から継承されたメソッド

addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, 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)