Класс NamingException

public class NamingException
extends Exception

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

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

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

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

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

Поля

resolvedName

protected Name resolvedName

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

См. также:

getResolvedName(), setResolvedName(javax.naming.Name)

resolvedObj

protected Object resolvedObj

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

См. также:

getResolvedObj(), setResolvedObj(java.lang.Object)

remainingName

protected Name remainingName

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

См. также:

getRemainingName(), setRemainingName(javax.naming.Name), appendRemainingName(javax.naming.Name), appendRemainingComponent(java.lang.String)

rootException

protected Throwable rootException

См. также:

getRootCause(), setRootCause(Throwable), initCause(Throwable), getCause()

Конструкторы

NamingException

public NamingException(String explanation)

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

Параметры:

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

См. также:

Throwable.getMessage()

NamingException

public NamingException()

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

Методы

getResolvedName

public Name getResolvedName()

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

Возвращает:

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

См. также:

getResolvedObj(), setResolvedName(javax.naming.Name)

getRemainingName

public Name getRemainingName()

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

Возвращает:

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

См. также:

setRemainingName(javax.naming.Name), appendRemainingName(javax.naming.Name), appendRemainingComponent(java.lang.String)

getResolvedObj

public Object getResolvedObj()

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

Возвращает:

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

См. также:

getResolvedName(), setResolvedObj(java.lang.Object)

getExplanation

public String getExplanation()

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

Возвращает:

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

См. также:

Throwable.getMessage()

setResolvedName

public void setResolvedName(Name name)

Параметры:

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

См. также:

getResolvedName()

setRemainingName

public void setRemainingName(Name name)

Параметры:

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

См. также:

getRemainingName(), appendRemainingName(javax.naming.Name), appendRemainingComponent(java.lang.String)

setResolvedObj

public void setResolvedObj(Object obj)

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

Параметры:

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

См. также:

getResolvedObj()

appendRemainingComponent

public void appendRemainingComponent(String name)

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

Параметры:

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

См. также:

setRemainingName(javax.naming.Name), getRemainingName(), appendRemainingName(javax.naming.Name)

appendRemainingName

public void appendRemainingName(Name name)

Параметры:

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

См. также:

setRemainingName(javax.naming.Name), getRemainingName(), appendRemainingComponent(java.lang.String)

getRootCause

public Throwable getRootCause()

Возвращает:

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

См. также:

setRootCause(java.lang.Throwable), rootException, getCause()

setRootCause

public void setRootCause(Throwable e)

Параметры:

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

См. также:

getRootCause(), rootException, initCause(java.lang.Throwable)

getCause

public Throwable getCause()

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

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

getCause в классе Throwable

Возвращает:

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

С момента:

1.4

См. также:

initCause(Throwable)

initCause

public Throwable initCause(Throwable cause)

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

initCause в классе Throwable

Параметры:

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

Возвращает:

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

Исключения:

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

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

С момента:

1.4

См. также:

getCause()

toString

public String toString()

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

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

toString в классе Throwable

Возвращает:

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

toString

public String toString(boolean detail)

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

Параметры:

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

Возвращает:

Непустую строку, содержащую строковое представление.