JavaTM 2 Platform
Standard Ed. 5.0

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 から継承されたメソッド
fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, 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()
この例外の文字列表現は、エラーが発生した位置に関する情報、および実行されなかった最初の変更で構成されます。この文字列はデバッグに使用され、プログラムによって解釈されることはありません。

オーバーライド:
クラス NamingException 内の toString
戻り値:
この例外の null 以外の文字列表現

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。