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 以外の文字列表現。