Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| JavaTM 2 Platform Standard Ed. 5.0
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## 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

Field Summary

Fields inherited from class javax.naming.NamingException
`remainingName, resolvedName, resolvedObj, rootException`

Constructor Summary
`AttributeModificationException()` Constructs a new instance of AttributeModificationException.
`AttributeModificationException(String explanation)` Constructs a new instance of AttributeModificationException using an explanation.

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

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
`fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, printStackTrace, printStackTrace, printStackTrace, setStackTrace`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

Constructor Detail

### 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 no detail message.
  See Also:
    `Throwable.getMessage()`

### AttributeModificationException

    public AttributeModificationException()

  Constructs a new instance of AttributeModificationException. All fields are set to null.

Method Detail

### 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.

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| JavaTM 2 Platform Standard Ed. 5.0
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

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.

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.