Класс NamingException

javax.naming.NamingException

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

public class NamingException extends Exception

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

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

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

Методы, объявленные в классе 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, либо пока не истечёт заданный промежуток реального времени.

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

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 — добавляемый компонент. Если значение 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()

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

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

getCause в классе Throwable

Возвращает:

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

С версии:

1.4

См. также:

initCause

public Throwable initCause(Throwable cause)

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

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

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

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.