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 declared in class javax.naming.NamingException

remainingName, resolvedName, resolvedObj, rootException

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
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 declared in class javax.naming.NamingException

appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause, toString

Methods declared in class java.lang.Throwable

addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods declared in class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

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 Details

setUnexecutedModifications

public void setUnexecutedModifications(