Класс NamingException

javax.naming.NamingException

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

public class NamingException extends Exception

Этот класс является суперклассом всех исключений, выбрасываемых операциями в интерфейсах Context и DirContext. Характер ошибки описывается именем подкласса. Это исключение содержит информацию о том, где произошла ошибка во время операции, например, до какой точки была выполнена разрешение.

Разрешенное имя. Часть имени, которая была разрешена.
Разрешенный объект. Объект, к которому было выполнено разрешение имени.
Остаток имени. Часть имени, которая не была разрешена.
Объяснение. Подробное объяснение причины неудачи разрешения имени.
Корневое исключение. Исключение, которое привело к возникновению этого исключения NamingException.

null является допустимым значением для любого из этих полей. Если поле равно null, это означает, что для этого поля не было зафиксировано никакой информации.

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

Это исключение было адаптировано для соответствия общему механизму обработки исключений. Корневое исключение (или первопричина) — это тот же объект, что и причина, возвращаемая методом Throwable.getCause().

С момента:

1.3

См. также:

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

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

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

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

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

Модификатор и тип	Метод	Описание
`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()`	Генерирует строковое представление этого исключения.
`String`	`toString(boolean detail)`	Генерирует строковое представление более подробно.

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

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

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

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

Подробное описание полей

resolvedName

protected Name resolvedName

Содержит часть имени, которая была успешно разрешена. Это составное имя и может быть null. Это поле инициализируется конструкторами. Доступ к этому полю и его изменение следует осуществлять через методы get и set.

См. также:

resolvedObj

protected Object resolvedObj

Содержит объект, до которого было успешно выполнено разрешение части имени. Может быть null. Это поле инициализируется конструкторами. Доступ к этому полю и его изменение следует осуществлять через методы get и set.

См. также:

remainingName

protected Name remainingName

Содержит оставшуюся часть имени, которая еще не была разрешена. Это составное имя и может быть null. Это поле инициализируется конструкторами. Доступ к этому полю и его изменение следует осуществлять через методы get, set и «append».

См. также:

rootException

protected Throwable rootException

Содержит исходное исключение, которое вызвало это исключение NamingException. Это поле устанавливается, если есть дополнительная информация, которая может быть получена из исходного исключения, или если исходное исключение не может быть сопоставлено с подклассом NamingException. Может быть null.

Это поле предшествует общедоступной функции цепочки исключений. Методы initCause(Throwable) и getCause() сейчас являются предпочтительным способом доступа к этой информации.

См. также:

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

NamingException

public NamingException(String explanation)

Создает новое исключение NamingException с пояснением. Все не указанные поля устанавливаются в null.

Параметры:

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

См. также:

NamingException

public NamingException()

Создает новое исключение NamingException. Все поля устанавливаются в null.

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

getResolvedName

public Name getResolvedName()

Возвращает ведущую часть имени, которая была успешно разрешена.

Возвращает:

Часть имени, которая была успешно разрешена. Это составное имя. Может быть null, что означает, что поле разрешенного имени не было установлено.

См. также:

getRemainingName

public Name getRemainingName()

Возвращает оставшуюся неразрешенную часть имени.

Возвращает:

Часть имени, которая не была разрешена. Это составное имя. Может быть null, что означает, что поле оставшегося имени не было установлено.

См. также:

getResolvedObj

public Object getResolvedObj()

Возвращает объект, до которого было выполнено успешное разрешение. Это объект, к которому привязано разрешенное имя.

Возвращает:

Возможный null-объект, который был разрешен до этого момента. null означает, что поле разрешенного объекта не было установлено.

См. также:

getExplanation

public String getExplanation()

Возвращает объяснение, связанное с этим исключением.

Возвращает:

Возможная null-строка, поясняющая больше о данном исключении. Если null, это означает, что нет сообщения об ошибке для этого исключения.

См. также:

setResolvedName

public void setResolvedName(Name name)

Устанавливает поле разрешенного имени этого исключения.

name - составное имя. Если целью является установка этого поля с помощью составного имени или строки, необходимо «преобразовать» составное имя в строку и создать составное имя с одним компонентом, используя эту строку. Затем можно вызвать этот метод, используя полученное составное имя.

Создается копия name и сохраняется. Последующие изменения name не влияют на копию в этом NamingException и наоборот.

Параметры:

name - Возможно null-имя, которое нужно установить для поля разрешенного имени. Если null, устанавливает поле разрешенного имени в null.

См. также:

setRemainingName

public void setRemainingName(Name name)

Устанавливает поле оставшегося имени этого исключения.

Создается копия name и сохраняется. Последующие изменения name не влияют на копию в этом NamingException и наоборот.

Параметры:

name - Возможно null-имя, которое нужно установить для поля оставшегося имени. Если null, устанавливает поле оставшегося имени в null.

См. также:

setResolvedObj

public void setResolvedObj(Object obj)

Устанавливает поле разрешенного объекта этого исключения.

Параметры:

obj - Возможно null-объект, который нужно установить для поля разрешенного объекта. Если null, поле разрешенного объекта устанавливается в null.

См. также:

appendRemainingComponent

public void appendRemainingComponent(String name)

Добавляет имя как последний компонент в оставшееся имя.

Параметры:

name - Компонент для добавления. Если имя null, этот метод ничего не делает.

См. также:

appendRemainingName

public void appendRemainingName(Name name)

Добавляет компоненты из «имени» как последние компоненты в оставшееся имя.

name - составное имя. Если нужно добавить составное имя, необходимо преобразовать составное имя в строку, а затем вызвать перегруженный метод, принимающий строковый параметр.

Последующие изменения в name не влияют на поле оставшегося имени в этом NamingException и наоборот.

Параметры:

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

См. также:

getRootCause

public Throwable getRootCause()

Возвращает причину возникновения исключения NamingException, если она есть. Причина возникновения исключения используется, когда поставщик сервиса хочет указать вызывающей стороне исключение, не связанное с именованием, но при этом хочет использовать структуру NamingException для указания того, как далеко продвинулась операция именования.

Этот метод предшествует общей функциональности цепочки исключений. Метод getCause() в настоящее время является предпочтительным способом получения этой информации.

Возвращает:

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

См. также:

setRootCause

public void setRootCause(Throwable e)

Записывает корневую причину данного исключения NamingException. Если e равно this, этот метод ничего не делает.

Этот метод предшествует общей функциональности цепочки исключений. Метод initCause(Throwable) в настоящее время является предпочтительным способом записи этой информации.

Параметры:

e - Возможная исключительная ситуация, вызвавшая сбой операции именования. Если null, это означает, что для этого исключения именования нет корневой причины.

См. также:

getCause

public Throwable getCause()

Возвращает причину возникновения этого исключения. Причина — это исключительная ситуация, которая привела к тому, что было выброшено это исключение именования. Возвращает null, если причина отсутствует или неизвестна.

Переопределяет:

getCause в классе Throwable

Возвращает:

причина этого исключения, или null, если причина отсутствует или неизвестна.

С момента:

1.4

См. также:

initCause

public Throwable initCause(Throwable cause)

Инициализирует причину этого исключения указанным значением. Причина — это исключительная ситуация, которая привела к тому, что было выброшено это исключение именования.

Этот метод может быть вызван не более одного раза.

Переопределяет:

initCause в классе Throwable

Параметры:

cause — причина, которая сохраняется для последующего извлечения методом getCause(). Значение null указывает, что причина отсутствует или неизвестна.

Возвращает:

ссылка на этот экземпляр NamingException.

Исключения:

IllegalArgumentException - если cause является этим исключением. (Исключительная ситуация не может быть своей собственной причиной.)

IllegalStateException - если этот метод уже был вызван для этого исключения.

С момента:

1.4

См. также:

toString

public String toString()

Генерирует строковое представление этого исключения. Строковое представление состоит из имени класса этого исключения, его подробного сообщения и, если есть корневая причина, строкового представления исключения корневой причины, за которым следует оставшееся имя (если оно не null). Эта строка используется для отладки и не предназначена для программной интерпретации.

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

toString

public String toString(boolean detail)

Генерирует строковое представление более подробно. Это строковое представление состоит из информации, возвращаемой методом toString() без параметров, плюс строковое представление разрешенного объекта (если он не null). Эта строка используется для отладки и не предназначена для программной интерпретации.

Параметры:: detail - Если true, включать подробности о разрешенном объекте помимо другой информации.
Возвращает:: Непустая строка, содержащая строковое представление.

© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.naming/javax/naming/NamingException.html