模块 java.naming
包 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() 的顺序排列。如果列表为空，则没有任何修改成功执行。

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

自从：
1.3
参见：

  • 构造方法详细信息

    • AttributeModificationException

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

    • AttributeModificationException

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

  • 方法详情

    • setUnexecutedModifications

      public void setUnexecutedModifications(ModificationItem [] e)
      设置未执行的修改列表为e。列表中的项目必须按照它们最初在 DirContext.modifyAttributes() 中提供的相同顺序出现。列表中的第一项是第一个未执行的项目。如果此list为空，则最初提交给 modifyAttributes() 的操作均未执行。
      参数：
      e - 未执行修改的可能为空的列表。
      参见：

    • getUnexecutedModifications

      public ModificationItem [] getUnexecutedModifications()
      检索未执行的修改列表。列表中项目的显示顺序与它们最初在 DirContext.modifyAttributes() 中提供的顺序相同。列表中的第一项是第一个未执行的项目。如果此list为空，则最初提交给 modifyAttributes() 的操作均未执行。
      返回：
      可能为空的未执行修改列表。
      参见：

    • toString

      public String  toString()
      此异常的字符串表示形式包含有关错误发生位置的信息，以及第一个未执行的修改。此字符串用于调试，并不意味着以编程方式进行解释。
      重写：
      toString 在类 NamingException 中
      返回：
      此异常的非空字符串表示形式。