compact3

javax.naming.directory

Class AttributeModificationException

java.lang.Object

java.lang.Throwable

java.lang.Exception

javax.naming.NamingException

javax.naming.directory.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

Field Summary

Fields inherited from class javax.naming.NamingException

remainingName, resolvedName, resolvedObj, rootException

构造方法摘要

构造方法

Constructor and Description
AttributeModificationException() 构造一个新的AttributeModificationException实例。
AttributeModificationException(String explanation) 使用说明构造一个新的AttributeModificationException实例。

方法摘要

Modifier and Type	Method and Description
ModificationItem[]	getUnexecutedModifications() 检索未执行的修改列表。
void	setUnexecutedModifications(ModificationItem[] e) 将未执行的修改列表设置为e。
String	toString() 此异常的字符串表示形式包含有关错误发生位置的信息和第一个未执行的修改。

Methods inherited from class javax.naming.NamingException

appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause, toString

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造方法详细信息

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 - e的可能的空列表。

另请参见：

getUnexecutedModifications()

getUnexecutedModifications

public ModificationItem[] getUnexecutedModifications()

检索未执行的修改列表。 列表中的项目以与DirContext.modifyAttributes（）中最初提供的顺序相同的顺序显示。 列表中的第一个项目是第一个没有执行的项目。 如果此列表为空，则不会执行最初提交给modifyAttributes（）的操作。

结果

可能为null未执行的修改列表。

另请参见：

setUnexecutedModifications(javax.naming.directory.ModificationItem[])

toString

public String toString()

此异常的字符串表示形式包含有关错误发生位置的信息和第一个未执行的修改。 此字符串用于调试，而不是以编程方式进行解释。

重写：

toString在类别 NamingException

结果

此异常的非空字符串表示形式。