Класс AttributeModificationException

javax.naming.directory.AttributeModificationException

Все реализуемые интерфейсы:: Serializable

public class AttributeModificationException extends NamingException

Это исключение выбрасывается при попытке добавить, удалить или изменить атрибут, его идентификатор или значения, если это противоречит определению (схеме) атрибута или его состоянию. Оно выбрасывается в ответ на вызов DirContext.modifyAttributes(). Исключение содержит список изменений, которые не были выполнены, в том порядке, в котором они были переданы в modifyAttributes(). Если список равен null, ни одно из изменений не было выполнено успешно.

Экземпляр AttributeModificationException не синхронизирован для одновременного доступа из нескольких потоков. Несколько потоков, пытающихся получить доступ к одному экземпляру AttributeModification и изменить его, должны блокировать объект.

Начиная с:

1.3

См. также:

Краткое описание полей

Поля, объявленные в классе NamingException

remainingName, resolvedName, resolvedObj, rootException

Модификатор и тип	Поле	Описание
`protected Name`	`remainingName`	Содержит оставшуюся часть имени, разрешение которой еще не выполнено.
`protected Name`	`resolvedName`	Содержит часть имени, разрешение которой было успешно выполнено.
`protected Object`	`resolvedObj`	Содержит объект, для которого разрешение части имени было выполнено успешно.
`protected Throwable`	`rootException`	Содержит исходное исключение, вызвавшее это исключение NamingException.

Краткое описание конструкторов

Конструктор	Описание
`AttributeModificationException()`	Создает новый экземпляр AttributeModificationException.
`AttributeModificationException(String explanation)`	Создает новый экземпляр AttributeModificationException с пояснением.

Краткое описание методов

Модификатор и тип	Метод	Описание
`ModificationItem[]`	`getUnexecutedModifications()`	Возвращает список невыполненных изменений.
`void`	`setUnexecutedModifications(ModificationItem[] e)`	Задает список невыполненных изменений для выполнения.
`String`	`toString()`	Строковое представление этого исключения содержит сведения о месте возникновения ошибки и первом невыполненном изменении.

Методы, объявленные в классе NamingException

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

Модификатор и тип	Метод	Описание
`void`	`appendRemainingComponent(String name)`	Добавляет имя в конец оставшейся части имени.
`void`	`appendRemainingName(Name name)`	Добавляет компоненты из 'name' в конец оставшейся части имени.
`Throwable`	`getCause()`	Возвращает причину этого исключения.
`String`	`getExplanation()`	Возвращает пояснение, связанное с этим исключением.
`Name`	`getRemainingName()`	Возвращает оставшуюся неразрешенную часть имени.
`Name`	`getResolvedName()`	Возвращает начальную часть имени, разрешение которой было успешно выполнено.
`Object`	`getResolvedObj()`	Возвращает объект, для которого разрешение было выполнено успешно.
`Throwable`	`getRootCause()`	Возвращает корневую причину этого исключения NamingException, если она есть.
`Throwable`	`initCause(Throwable cause)`	Инициализирует причину этого исключения указанным значением.
`void`	`setRemainingName(Name name)`	Задает поле оставшейся части имени этого исключения.
`void`	`setResolvedName(Name name)`	Задает поле разрешенного имени этого исключения.
`void`	`setResolvedObj(Object obj)`	Задает поле разрешенного объекта этого исключения.
`void`	`setRootCause(Throwable e)`	Записывает корневую причину этого исключения NamingException.
`String`	`toString(boolean detail)`	Формирует более подробное строковое представление.

Методы, объявленные в классе Throwable

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

Модификатор и тип	Метод	Описание
`final void`	`addSuppressed(Throwable exception)`	Добавляет указанное исключение к исключениям, подавленным для передачи этого исключения.
`Throwable`	`fillInStackTrace()`	Заполняет трассировку стека вызовов.
`String`	`getLocalizedMessage()`	Создает локализованное описание этого объекта throwable.
`String`	`getMessage()`	Возвращает строку с подробным сообщением этого объекта throwable.
`StackTraceElement[]`	`getStackTrace()`	Предоставляет программный доступ к сведениям о трассировке стека, выводимым методом `Throwable.printStackTrace()`.
`final Throwable[]`	`getSuppressed()`	Возвращает массив, содержащий все исключения, подавленные, как правило, оператором `try`-with-resources, для передачи этого исключения.
`void`	`printStackTrace()`	Выводит этот объект throwable и его трассировку в стандартный поток ошибок.
`void`	`printStackTrace(PrintStream s)`	Выводит этот объект throwable и его трассировку в указанный поток печати.
`void`	`printStackTrace(PrintWriter s)`	Выводит этот объект throwable и его трассировку в указанный объект записи.
`void`	`setStackTrace(StackTraceElement[] stackTrace)`	Задает элементы трассировки стека, которые будут возвращаться методом `Throwable.getStackTrace()` и выводиться методами `Throwable.printStackTrace()` и связанными с ними.

Методы, объявленные в классе Object

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарело и подлежит удалению: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого объекта `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Подробное описание конструкторов

AttributeModificationException

public AttributeModificationException(String explanation)

Создает новый экземпляр AttributeModificationException с пояснением. Все остальные поля устанавливаются в null.

Параметры:

explanation — возможно, дополнительные сведения об этом исключении, которые могут быть равны null. Если значение равно null, у исключения нет подробного сообщения.

См. также:

AttributeModificationException

public AttributeModificationException()

Создает новый экземпляр AttributeModificationException. Все поля устанавливаются в null.

Подробное описание методов

setUnexecutedModifications

public void setUnexecutedModifications(ModificationItem[] e)

Задает список невыполненных изменений. Элементы списка должны располагаться в том же порядке, в котором они были первоначально переданы в DirContext.modifyAttributes(). Первый элемент списка — первый элемент, который не был выполнен. Если список равен null, ни одна из операций, первоначально переданных в modifyAttributes(), не была выполнена.

Параметры:

e — возможно, список невыполненных изменений, который может быть равен null.

См. также:

getUnexecutedModifications

public ModificationItem[] getUnexecutedModifications()

Возвращает список невыполненных изменений. Элементы списка располагаются в том же порядке, в котором они были первоначально переданы в DirContext.modifyAttributes(). Первый элемент списка — первый элемент, который не был выполнен. Если список равен null, ни одна из операций, первоначально переданных в modifyAttributes(), не была выполнена.

Возвращает:

Возможно, список невыполненных изменений, равный null.

См. также:

toString

public String toString()

Строковое представление этого исключения содержит сведения о месте возникновения ошибки и первом невыполненном изменении. Эта строка предназначена для отладки и не должна интерпретироваться программно.

Переопределяет:: toString в классе NamingException
Возвращает:: Ненулевое строковое представление этого исключения.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.