javax.naming.directory
Class AttributeModificationException

java.lang.Object sample code for java.lang.Object definition code for java.lang.Object 
  extended by java.lang.Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable 
      extended by java.lang.Exception sample code for java.lang.Exception definition code for java.lang.Exception 
          extended by javax.naming.NamingException sample code for javax.naming.NamingException definition code for javax.naming.NamingException 
              extended by javax.naming.directory.AttributeModificationException
All Implemented Interfaces:
Serializable sample code for java.io.Serializable definition code for java.io.Serializable

public class AttributeModificationException
extends NamingException sample code for javax.naming.NamingException definition code for javax.naming.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) sample code for javax.naming.directory.DirContext.modifyAttributes(javax.naming.Name, int, javax.naming.directory.Attributes) definition code for javax.naming.directory.DirContext.modifyAttributes(javax.naming.Name, int, javax.naming.directory.Attributes) , Serialized Form

Field Summary
 
Fields inherited from class javax.naming.NamingException sample code for javax.naming.NamingException definition code for javax.naming.NamingException
remainingName sample code for javax.naming.NamingException.remainingName definition code for javax.naming.NamingException.remainingName , resolvedName sample code for javax.naming.NamingException.resolvedName definition code for javax.naming.NamingException.resolvedName , resolvedObj sample code for javax.naming.NamingException.resolvedObj definition code for javax.naming.NamingException.resolvedObj , rootException sample code for javax.naming.NamingException.rootException definition code for javax.naming.NamingException.rootException
 
Constructor Summary
AttributeModificationException sample code for javax.naming.directory.AttributeModificationException.AttributeModificationException() definition code for javax.naming.directory.AttributeModificationException.AttributeModificationException() ()
          Constructs a new instance of AttributeModificationException.
AttributeModificationException sample code for javax.naming.directory.AttributeModificationException.AttributeModificationException(java.lang.String) definition code for javax.naming.directory.AttributeModificationException.AttributeModificationException(java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  explanation)
          Constructs a new instance of AttributeModificationException using an explanation.
 
Method Summary
 ModificationItem sample code for javax.naming.directory.ModificationItem definition code for javax.naming.directory.ModificationItem [] getUnexecutedModifications sample code for javax.naming.directory.AttributeModificationException.getUnexecutedModifications() definition code for javax.naming.directory.AttributeModificationException.getUnexecutedModifications() ()
          Retrieves the unexecuted modification list.
 void setUnexecutedModifications sample code for javax.naming.directory.AttributeModificationException.setUnexecutedModifications(javax.naming.directory.ModificationItem[]) definition code for javax.naming.directory.AttributeModificationException.setUnexecutedModifications(javax.naming.directory.ModificationItem[]) (ModificationItem sample code for javax.naming.directory.ModificationItem definition code for javax.naming.directory.ModificationItem [] e)
          Sets the unexecuted modification list to be e.
 String sample code for java.lang.String definition code for java.lang.String toString sample code for javax.naming.directory.AttributeModificationException.toString() definition code for javax.naming.directory.AttributeModificationException.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 sample code for javax.naming.NamingException definition code for javax.naming.NamingException
appendRemainingComponent sample code for javax.naming.NamingException.appendRemainingComponent(java.lang.String) definition code for javax.naming.NamingException.appendRemainingComponent(java.lang.String) , appendRemainingName sample code for javax.naming.NamingException.appendRemainingName(javax.naming.Name) definition code for javax.naming.NamingException.appendRemainingName(javax.naming.Name) , getCause sample code for javax.naming.NamingException.getCause() definition code for javax.naming.NamingException.getCause() , getExplanation sample code for javax.naming.NamingException.getExplanation() definition code for javax.naming.NamingException.getExplanation() , getRemainingName sample code for javax.naming.NamingException.getRemainingName() definition code for javax.naming.NamingException.getRemainingName() , getResolvedName sample code for javax.naming.NamingException.getResolvedName() definition code for javax.naming.NamingException.getResolvedName() , getResolvedObj sample code for javax.naming.NamingException.getResolvedObj() definition code for javax.naming.NamingException.getResolvedObj() , getRootCause sample code for javax.naming.NamingException.getRootCause() definition code for javax.naming.NamingException.getRootCause() , initCause sample code for javax.naming.NamingException.initCause(java.lang.Throwable) definition code for javax.naming.NamingException.initCause(java.lang.Throwable) , setRemainingName sample code for javax.naming.NamingException.setRemainingName(javax.naming.Name) definition code for javax.naming.NamingException.setRemainingName(javax.naming.Name) , setResolvedName sample code for javax.naming.NamingException.setResolvedName(javax.naming.Name) definition code for javax.naming.NamingException.setResolvedName(javax.naming.Name) , setResolvedObj sample code for javax.naming.NamingException.setResolvedObj(java.lang.Object) definition code for javax.naming.NamingException.setResolvedObj(java.lang.Object) , setRootCause sample code for javax.naming.NamingException.setRootCause(java.lang.Throwable) definition code for javax.naming.NamingException.setRootCause(java.lang.Throwable) , toString sample code for javax.naming.NamingException.toString(boolean) definition code for javax.naming.NamingException.toString(boolean)
 
Methods inherited from class java.lang.Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable
fillInStackTrace sample code for java.lang.Throwable.fillInStackTrace() definition code for java.lang.Throwable.fillInStackTrace() , getLocalizedMessage sample code for java.lang.Throwable.getLocalizedMessage() definition code for java.lang.Throwable.getLocalizedMessage() , getMessage sample code for java.lang.Throwable.getMessage() definition code for java.lang.Throwable.getMessage() , getStackTrace sample code for java.lang.Throwable.getStackTrace() definition code for java.lang.Throwable.getStackTrace() , printStackTrace sample code for java.lang.Throwable.printStackTrace() definition code for java.lang.Throwable.printStackTrace() , printStackTrace sample code for java.lang.Throwable.printStackTrace(java.io.PrintStream) definition code for java.lang.Throwable.printStackTrace(java.io.PrintStream) , printStackTrace sample code for java.lang.Throwable.printStackTrace(java.io.PrintWriter) definition code for java.lang.Throwable.printStackTrace(java.io.PrintWriter) , setStackTrace sample code for java.lang.Throwable.setStackTrace(java.lang.StackTraceElement[]) definition code for java.lang.Throwable.setStackTrace(java.lang.StackTraceElement[])
 
Methods inherited from class java.lang.Object sample code for java.lang.Object definition code for java.lang.Object
clone sample code for java.lang.Object.clone() definition code for java.lang.Object.clone() , equals sample code for java.lang.Object.equals(java.lang.Object) definition code for java.lang.Object.equals(java.lang.Object) , finalize sample code for java.lang.Object.finalize() definition code for java.lang.Object.finalize() , getClass sample code for java.lang.Object.getClass() definition code for java.lang.Object.getClass() , hashCode sample code for java.lang.Object.hashCode() definition code for java.lang.Object.hashCode() , notify sample code for java.lang.Object.notify() definition code for java.lang.Object.notify() , notifyAll sample code for java.lang.Object.notifyAll() definition code for java.lang.Object.notifyAll() , wait sample code for java.lang.Object.wait() definition code for java.lang.Object.wait() , wait sample code for java.lang.Object.wait(long) definition code for java.lang.Object.wait(long) , wait sample code for java.lang.Object.wait(long, int) definition code for java.lang.Object.wait(long, int)
 

Constructor Detail

AttributeModificationException sample code for javax.naming.directory.AttributeModificationException(java.lang.String) definition code for javax.naming.directory.AttributeModificationException(java.lang.String)

public AttributeModificationException(String sample code for java.lang.String definition code for java.lang.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() sample code for java.lang.Throwable.getMessage() definition code for java.lang.Throwable.getMessage()

AttributeModificationException sample code for javax.naming.directory.AttributeModificationException() definition code for javax.naming.directory.AttributeModificationException()

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

Method Detail

setUnexecutedModifications sample code for javax.naming.directory.AttributeModificationException.setUnexecutedModifications(javax.naming.directory.ModificationItem[]) definition code for javax.naming.directory.AttributeModificationException.setUnexecutedModifications(javax.naming.directory.ModificationItem[])

public void setUnexecutedModifications(ModificationItem sample code for javax.naming.directory.ModificationItem definition code for javax.naming.directory.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() sample code for javax.naming.directory.AttributeModificationException.getUnexecutedModifications() definition code for javax.naming.directory.AttributeModificationException.getUnexecutedModifications()

getUnexecutedModifications sample code for javax.naming.directory.AttributeModificationException.getUnexecutedModifications() definition code for javax.naming.directory.AttributeModificationException.getUnexecutedModifications()

public ModificationItem sample code for javax.naming.directory.ModificationItem definition code for javax.naming.directory.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[]) sample code for javax.naming.directory.AttributeModificationException.setUnexecutedModifications(javax.naming.directory.ModificationItem[]) definition code for javax.naming.directory.AttributeModificationException.setUnexecutedModifications(javax.naming.directory.ModificationItem[])

toString sample code for javax.naming.directory.AttributeModificationException.toString() definition code for javax.naming.directory.AttributeModificationException.toString()

public String sample code for java.lang.String definition code for java.lang.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 sample code for javax.naming.NamingException.toString() definition code for javax.naming.NamingException.toString() in class NamingException sample code for javax.naming.NamingException definition code for javax.naming.NamingException
Returns:
The non-null string representation of this exception.