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

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

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

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

オーバーライド:

クラス NamingException 内の toString

戻り値:

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