モジュール java.naming

パッケージ javax.naming.directory

クラスAttributeModificationException

java.lang.Object

java.lang.Throwable

java.lang.Exception

javax.naming.NamingException

javax.naming.directory.AttributeModificationException

すべての実装されたインタフェース:

Serializable

public class AttributeModificationException extends NamingException

この例外は、属性の(スキーマ)定義や属性の状態と矛盾する、属性、その識別子、またはその値の追加、削除、または変更を実行しようとするとスローされます。 この例外はDirContext.modifyAttributes()に応答してスローされます。 この属性には、実行されなかった変更のリストが、modifyAttributes()に指定された順序で含まれます。 リストがnullの場合は、どの変更も正常に実行されなかったことを示します。

AttributeModificationExceptionインスタンスは、並行マルチスレッド・アクセスに対して同期化されません。 単一のAttributeModificationインスタンスへのアクセスおよびそのインスタンスを変更しようとする複数のスレッドによって、オブジェクトはロックされます。

導入されたバージョン:

1.3

関連項目:

• DirContext.modifyAttributes(javax.naming.Name, int, javax.naming.directory.Attributes)
• 直列化された形式

フィールドのサマリー

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

remainingName, resolvedName, resolvedObj, rootException

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

コンストラクタ

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

メソッドのサマリー

修飾子と型	メソッド	説明
ModificationItem[]	getUnexecutedModifications()	実行されなかった変更のリストを取り出します。
void	setUnexecutedModifications(ModificationItem[] e)	実行されなかった変更のリストをeに設定します。
String	toString()	この例外の文字列表現は、エラーが発生した位置に関する情報、および実行されなかった最初の変更で構成されます。

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

appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause, 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

コンストラクタの詳細

AttributeModificationException

public AttributeModificationException(String explanation)

説明を使用して、AttributeModificationExceptionの新しいインスタンスを構築します。 ほかのフィールドはすべてnullに設定されます。

パラメータ:

explanation - この例外に関するnullの可能性がある追加の詳細情報。 nullの場合、この例外には詳細メッセージはない。

関連項目:

• Throwable.getMessage()

AttributeModificationException

public AttributeModificationException()

AttributeModificationExceptionの新しいインスタンスを構築します。 フィールドはすべてnullに設定されます。

メソッドの詳細

setUnexecutedModifications

public void setUnexecutedModifications(ModificationItem[] e)

実行されなかった変更のリストをeに設定します。 リスト内の項目は、DirContext.modifyAttributes()で最初に指定されたのと同じ順序で表示する必要があります。 リスト内の最初の項目は、実行されなかった最初の項目になります。 このリストがnullの場合、modifyAttributes()に最初に送信された操作は実行されなかったことになります。

パラメータ:

e - nullの可能性がある、実行されなかった変更のリスト。

関連項目:

• getUnexecutedModifications()

getUnexecutedModifications

public ModificationItem[] getUnexecutedModifications()

実行されなかった変更のリストを取り出します。 リスト内の項目は、DirContext.modifyAttributes()で最初に指定されたのと同じ順序で表示する必要があります。 リスト内の最初の項目は、実行されなかった最初の項目になります。 このリストがnullの場合、modifyAttributes()に最初に送信された操作は実行されなかったことになります。

戻り値:

nullの可能性がある実行されなかった変更のリスト。

関連項目:

• setUnexecutedModifications(javax.naming.directory.ModificationItem[])

toString

public String toString()

この例外の文字列表現は、エラーが発生した位置に関する情報、および実行されなかった最初の変更で構成されます。 この文字列はデバッグに使用され、プログラムによって解釈されることはありません。

オーバーライド:

toString、クラスNamingException

戻り値:

この例外のnull以外の文字列表現。