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
This exception 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
or the attribute's state.
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.
- Since:
- 1.3
- See Also:
DirContext.modifyAttributes(javax.naming.Name, int, javax.naming.directory.Attributes)
, Serialized Form
Methods inherited from class javax.naming.NamingException |
appendRemainingComponent, appendRemainingName, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, printStackTrace, printStackTrace, printStackTrace, setRemainingName, setResolvedName, setResolvedObj, setRootCause, toString |
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:
Throwable.getMessage()
AttributeModificationException
public AttributeModificationException()
- Constructs a new instance of AttributeModificationException.
All fields are set to null.
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 was not executed.
If this list is null, none of the operations originally submitted
to modifyAttributes() were executed.
- Parameters:
e
- The possibly null list of unexecuted modifications.- See Also:
getUnexecutedModifications()
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 was not executed.
If this list is null, none of the operations originally submitted
to modifyAttributes() were executed.
- Returns:
- The possibly null unexecuted modification list.
- See Also:
setUnexecutedModifications(javax.naming.directory.ModificationItem[])
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.
- Overrides:
toString
in class NamingException
- Returns:
- The non-null string representation of this exception.
Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples. Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.