javax.naming.directory

Class AttributeModificationException

Contents
  • 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

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

Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-javax/naming/directory/AttributeModificationException.html

The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.

References

  1. View the html document Language of the document:fr Manuel PHP : https://docs.oracle.com

These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.

Contents Haut