モジュール java.naming
パッケージ 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)、直列化された形式

    • コンストラクタの詳細

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