JavaTM 2 Platform
Standard Ed. 5.0

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() 的顺序排列。如果列表为 null,则不会成功执行任何修改。

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

从以下版本开始:
1.3
另请参见:
DirContext.modifyAttributes(javax.naming.Name, int, javax.naming.directory.Attributes), 序列化表格

字段摘要
 
从类 javax.naming.NamingException 继承的字段
remainingName, resolvedName, resolvedObj, rootException
 
构造方法摘要
AttributeModificationException()
          构造一个新的 AttributeModificationException 实例。
AttributeModificationException(String explanation)
          使用解释构造一个新的 AttributeModificationException 实例。
 
方法摘要
 ModificationItem[] getUnexecutedModifications()
          检索未执行修改的列表。
 void setUnexecutedModifications(ModificationItem[] e)
          将未执行的修改列表设置为 e。
 String toString()
          此异常的字符串表示形式由关于发生错误的位置信息和第一个未执行的修改组成。
 
从类 javax.naming.NamingException 继承的方法
appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause, toString
 
从类 java.lang.Throwable 继承的方法
fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, printStackTrace, printStackTrace, printStackTrace, setStackTrace
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

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()
此异常的字符串表示形式由关于发生错误的位置信息和第一个未执行的修改组成。此字符串用于调试,不以编程方式进行解释。

覆盖:
NamingException 中的 toString
返回:
此异常的非 null 字符串表示形式。

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策