Module  java.naming
软件包  javax.naming.directory

Class AttributeModificationException

  • All Implemented Interfaces:
    Serializable 

    public class AttributeModificationException
extends NamingException
    当尝试添加，删除或修改与属性（模式）定义或属性状态相冲突的属性，其标识符或其值时，将抛出此异常。 它被抛出以响应DirContext.modifyAttributes（）。 它包含未被执行的修改列表，按照它们提供给modifyAttributes（）的顺序。 如果列表为空，则不会成功执行任何修改。

    AttributeModificationException实例与并发多线程访问不同步。 尝试访问和修改单个AttributeModification实例的多个线程应锁定该对象。

    从以下版本开始：
    1.3
    另请参见：
    DirContext.modifyAttributes(javax.naming.Name, int, javax.naming.directory.Attributes) ， Serialized Form

    • 构造方法详细信息

      • AttributeModificationException

        public AttributeModificationException​(String explanation)
        使用说明构造一个新的AttributeModificationException实例。 所有其他字段都设置为null。
        参数
        explanation - 可能是关于此异常的额外详细信息。 如果为空，则此异常没有详细消息。
        另请参见：
        Throwable.getMessage()

      • AttributeModificationException

        public AttributeModificationException​()
        构造一个新的AttributeModificationException实例。 所有字段都设置为null。

    • 方法详细信息

      • setUnexecutedModifications

        public void setUnexecutedModifications​(ModificationItem[] e)
        将未执行的修改列表设置为e。 列表中的项目必须以与DirContext.modifyAttributes（）中最初提供的顺序相同的顺序显示。 列表中的第一个项目是第一个没有执行的项目。 如果此列表为空，则不会执行最初提交给modifyAttributes（）的操作。
        参数
        e - 未执行修改的可能的空列表。
        另请参见：
        getUnexecutedModifications()

      • getUnexecutedModifications

        public ModificationItem[] getUnexecutedModifications​()
        检索未执行的修改列表。 列表中的项目以与DirContext.modifyAttributes（）中最初提供的顺序相同的顺序显示。 列表中的第一个项目是第一个没有执行的项目。 如果此列表为空，则不会执行最初提交给modifyAttributes（）的操作。
        结果
        可能为null未执行的修改列表。
        另请参见：
        setUnexecutedModifications(javax.naming.directory.ModificationItem[])

      • toString

        public String toString​()
        此异常的字符串表示形式包含有关错误发生位置的信息和第一个未执行的修改。 此字符串用于调试，而不是以编程方式进行解释。
        重写：
        toString在 NamingException
        结果
        此异常的非空字符串表示形式。