Класс NamingException

javax.naming.NamingException

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

public class NamingException extends Exception

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

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

Для любого из этих полей допустимо значение 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)`	Формирует более подробное строковое представление.

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

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

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

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

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

resolvedName

protected Name resolvedName

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

См. также:

resolvedObj

protected Object resolvedObj

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

См. также:

remainingName

protected Name remainingName

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

См. также:

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 — компонент, который нужно добавить. Если значение name равно null, этот метод ничего не делает.

См. также:

appendRemainingName

public void appendRemainingName(Name name)

Добавляет компоненты из 'name' в качестве последних компонентов оставшейся части имени.

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

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

Параметры:

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

См. также:

getRootCause

public Throwable getRootCause()

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

Этот метод появился до создания универсального механизма связывания исключений. Для получения этих сведений теперь рекомендуется использовать метод getCause().

Возвращает:

Исключение, вызвавшее это исключение именования, возможно null. Значение null означает, что для этого исключения именования не задана корневая причина.

См. также:

setRootCause

public void setRootCause(Throwable e)

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

Этот метод появился до создания универсального механизма связывания исключений. Для записи этих сведений теперь рекомендуется использовать метод initCause(Throwable).

Параметры:

e — исключение, возможно null, вызвавшее сбой операции именования. Значение 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://docs.oracle.com/en/java/javase/25/docs/api/java.naming/javax/naming/NamingException.html