CannotProceedException (Java Platform SE 8)

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)

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスCannotProceedException

フィールドのサマリー

クラス javax.naming.NamingExceptionから継承されたフィールド

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

メソッドのサマリー

クラス javax.naming.NamingExceptionから継承されたメソッド

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

クラス java.lang.Objectから継承されたメソッド

フィールドの詳細

remainingNewName

environment

altName

altNameCtx

コンストラクタの詳細

CannotProceedException

CannotProceedException

メソッドの詳細

getEnvironment

setEnvironment

getRemainingNewName

setRemainingNewName

getAltName

setAltName

getAltNameCtx

setAltNameCtx