All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class javax.naming.directory.AttributeModificationException

java.lang.Object
   |
   +----java.lang.Throwable
           |
           +----java.lang.Exception
                   |
                   +----javax.naming.NamingException
                           |
                           +----javax.naming.directory.AttributeModificationException

public class AttributeModificationException
extends NamingException
AttributeModificationException is thrown when an attempt is made to add, or remove, or modify an attribute, its identifier, or its values that conflicts with the attribute's (schema) definition. It is thrown in response to DirContext.modifyAttributes(). It contains a list of modifications that have not been performed, in the order that they were supplied to modifyAttributes(). If the list is null, none of the modifications were performed successfully.

An AttributeModificationException instance is not synchronized against concurrent multithreaded access. Multiple threads trying to access and modify a single AttributeModification instance should lock the object.

The serialized form of an AttributeModificationException object consists of the serialized fields of its NamingException superclass, followed by an array of ModificationItem objects.

See Also:
modifyAttributes

Constructor Index

 o AttributeModificationException()
Constructs a new instance of AttributeModificationException.
 o AttributeModificationException(String)
Constructs a new instance of AttributeModificationException using an explanation.

Method Index

 o getUnexecutedModifications()
Retrieves the unexecuted modification list.
 o setUnexecutedModifications(ModificationItem[])
Sets the unexecuted modification list to be e.
 o toString()
The string representation of this exception consists of information about where the error occurred, and the first unexecuted modification.

Constructors

 o AttributeModificationException
 public AttributeModificationException(String explanation)
Constructs a new instance of AttributeModificationException using an explanation. All other fields are set to null.

Parameters:
explanation - Possibly null additional detail about this exception. If null, this exception has not detail message.
See Also:
getMessage
 o AttributeModificationException
 public AttributeModificationException()
Constructs a new instance of AttributeModificationException. All fields are set to null.

Methods

 o setUnexecutedModifications
 public void setUnexecutedModifications(ModificationItem e[])
Sets the unexecuted modification list to be e. Items in the list must appear in the same order in which they were originally supplied in DirContext.modifyAttributes(). The first item in the list is the first one that failed and caused this exception to be thrown. If this list is null, none of the operations originally submitted to modifyAttributes() were executed.

Parameters:
e - The possibly null list of unexecuted modifications.
 o getUnexecutedModifications
 public ModificationItem[] getUnexecutedModifications()
Retrieves the unexecuted modification list. Items in the list appear in the same order in which they were originally supplied in DirContext.modifyAttributes(). The first item in the list is the first one that failed and caused this exception to be thrown. If this list is null, none of the operations originally submitted to modifyAttributes() were executed.

Returns:
The possibly null unexecuted modification list.
 o toString
 public String toString()
The string representation of this exception consists of information about where the error occurred, and the first unexecuted modification. This string is meant for debugging and not mean to be interpreted programmatically.

Returns:
The non-null string representation of this exception.
Overrides:
toString in class NamingException

All Packages  Class Hierarchy  This Package  Previous  Next  Index