FileDocCategorySizeDatePackage
AttributeModificationException.javaAPI DocJava SE 6 API4077Tue Jun 10 00:26:20 BST 2008javax.naming.directory

AttributeModificationException

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.

author
Rosanna Lee
author
Scott Seligman
version
1.10 05/11/17
see
DirContext#modifyAttributes
since
1.3

Fields Summary
private ModificationItem[]
unexecs
Contains the possibly null list of unexecuted modifications.
private static final long
serialVersionUID
Use serialVersionUID from JNDI 1.1.1 for interoperability
Constructors Summary
public AttributeModificationException(String explanation)
Constructs a new instance of AttributeModificationException using an explanation. All other fields are set to null.

param
explanation Possibly null additional detail about this exception. If null, this exception has no detail message.
see
java.lang.Throwable#getMessage


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

	super();
    
Methods Summary
public 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.

return
The possibly null unexecuted modification list.
see
#setUnexecutedModifications

	return unexecs;
    
public voidsetUnexecutedModifications(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.

param
e The possibly null list of unexecuted modifications.
see
#getUnexecutedModifications

	unexecs = e;
    
public java.lang.StringtoString()
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.

return
The non-null string representation of this exception.

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