クラス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(Name, int, Attributes)
• 直列化された形式

フィールドのサマリー

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

remainingName, resolvedName, resolvedObj, rootException

修飾子と型	フィールド	説明
protected Name	remainingName	未解決の残りの名前を含みます。
protected Name	resolvedName	正常に解決された名前の部分を含みます。
protected Object	resolvedObj	名前の部分が正常に解決されたオブジェクトを含みます。
protected Throwable	rootException	このNamingExceptionがスローされる原因となった元の例外を含みます。

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

コンストラクタ

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

メソッドのサマリー

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

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

appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause, toString

修飾子と型	メソッド	説明
void	appendRemainingComponent(String name)	残りの名前の最後のコンポーネントとして名前を追加します。
void	appendRemainingName(Name name)	残りの名前の最後のコンポーネントとして「名前」からコンポーネントを追加します。
Throwable	getCause()	この例外の原因を返します。
String	getExplanation()	この例外に関連した説明を取得します。
Name	getRemainingName()	名前の残りの未解決部分を取得します。
Name	getResolvedName()	正常に解決された名前の先頭部分を取得します。
Object	getResolvedObj()	正常に解決されたオブジェクトを取得します。
Throwable	getRootCause()	このNamingExceptionの根本原因がある場合は、その根本原因を取得します。
Throwable	initCause(Throwable cause)	この例外の原因を、指定された値に初期化します。
void	setRemainingName(Name name)	この例外の残りの名前フィールドを設定します。
void	setResolvedName(Name name)	この例外の「resolvedName」フィールドを設定します。
void	setResolvedObj(Object obj)	この例外の「解決されたオブジェクト」フィールドを設定します。
void	setRootCause(Throwable e)	このNamingExceptionの根本原因を記録します。
String	toString(boolean detail)	より詳細な文字列表現が生成されます。

Throwableクラスで宣言されたメソッド

addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace

修飾子と型	メソッド	説明
final void	addSuppressed(Throwable exception)	この例外を提供する目的で抑制された例外に、指定された例外を追加します。
Throwable	fillInStackTrace()	実行スタック・トレースを埋め込みます。
String	getLocalizedMessage()	このスロー可能オブジェクトの、ローカライズされた記述を作成します。
String	getMessage()	このスロー可能オブジェクトの詳細メッセージ文字列を返します。
StackTraceElement[]	getStackTrace()	Throwable.printStackTrace()によって出力されるスタック・トレース情報にプログラムでアクセスできるようにします。
final Throwable[]	getSuppressed()	この例外を提供する目的で(通常try-with-resources文によって)抑制された例外をすべて含む配列を返します。
void	printStackTrace()	このスロー可能オブジェクトおよびそのバックトレースを標準エラー・ストリームに出力します。
void	printStackTrace(PrintStream s)	このスロー可能オブジェクトとそのバックトレースを指定された印刷ストリームに出力します。
void	printStackTrace(PrintWriter s)	このスロー可能オブジェクトとそのバックトレースを指定されたプリント・ライターに出力します。
void	setStackTrace(StackTraceElement[] stackTrace)	Throwable.getStackTrace()によって返され、Throwable.printStackTrace()と関連メソッドによって出力される、スタック・トレース要素を設定します。

クラスオブジェクトで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

修飾子と型	メソッド	説明
protected Object	clone()	このオブジェクトのコピーを作成して、返します。
boolean	equals(Object obj)	このオブジェクトと他のオブジェクトが等しいかどうかを示します。
protected void	finalize()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 最終決定は非推奨であり、将来のリリースで削除される可能性があります。
final Class<?>	getClass()	このObjectの実行時クラスを返します。
int	hashCode()	このオブジェクトに対するハッシュ・コード値を返します。
final void	notify()	このオブジェクトのモニターで待機中のスレッドを1つ再開します。
final void	notifyAll()	このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
final void	wait()	現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
final void	wait(long timeoutMillis)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
final void	wait(long timeoutMillis, int nanos)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

コンストラクタの詳細

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(ModificationItem[])

toString

public String toString()

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

オーバーライド:

toString、クラスNamingException

戻り値:

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