javax.naming.directory: public class: AttributeModificationException

javax.naming.directory
public class: AttributeModificationException [javadoc | source]

java.lang.Object
   java.lang.Throwable
      java.lang.Exception
         javax.naming.NamingException
            javax.naming.directory.AttributeModificationException

All Implemented Interfaces:
Serializable

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.

Also see:

DirContext#modifyAttributes

author: Rosanna - Lee

author: Scott - Seligman

since: 1.3 -

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

Fields inherited from java.lang.Exception:
serialVersionUID

Constructor:

Constructor:
public AttributeModificationException() { super(); } Constructs a new instance of AttributeModificationException. All fields are set to null.
public AttributeModificationException(String explanation) { super(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. Also see: java.lang.Throwable#getMessage

 public AttributeModificationException() {
        super();
}

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

 public AttributeModificationException(String explanation) {
        super(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.

Also see:

java.lang.Throwable#getMessage

Method from javax.naming.directory.AttributeModificationException Summary:
getUnexecutedModifications, setUnexecutedModifications, toString

Methods from javax.naming.NamingException:
appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause, toString, toString

Methods from java.lang.Throwable:
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getStackTraceDepth, getStackTraceElement, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods from java.lang.Object:
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from javax.naming.directory.AttributeModificationException Detail:
public ModificationItem[] getUnexecutedModifications() { return unexecs; } 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.
public void setUnexecutedModifications(ModificationItem[] e) { unexecs = 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.
public String toString() { String orig = super.toString(); if (unexecs != null) { orig += ("First unexecuted modification: " + unexecs[0].toString()); } return orig; } 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.

Method from javax.naming.directory.AttributeModificationException Detail:

 public ModificationItem[] getUnexecutedModifications() {
        return unexecs;
}

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.

 public  void setUnexecutedModifications(ModificationItem[] e) {
        unexecs = 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.

 public String toString() {
        String orig = super.toString();
        if (unexecs != null) {
            orig += ("First unexecuted modification: " +
                     unexecs[0].toString());
        }
        return orig;
}

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.