模块  java.naming
软件包  javax.naming.directory

Class 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) ， Serialized Form

    • 构造方法详细信息

      • AttributeModificationException

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

      • AttributeModificationException

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

    • 方法详细信息

      • setUnexecutedModifications

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

      • getUnexecutedModifications

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

      • toString

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