Класс LinkException

public class LinkException
extends NamingException

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

Аналогично тому, как NamingException захватывает информацию о разрешении имени, LinkException захватывает информацию о разрешении "ссылки", точно определяя проблему, возникшую при разрешении ссылки. Все эти поля могут быть равны null.

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

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

Поля

linkResolvedName

protected Name linkResolvedName

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

См. также:

getLinkResolvedName(), setLinkResolvedName(javax.naming.Name)

linkResolvedObj

protected Object linkResolvedObj

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

См. также:

getLinkResolvedObj(), setLinkResolvedObj(java.lang.Object)

linkRemainingName

protected Name linkRemainingName

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

См. также:

getLinkRemainingName(), setLinkRemainingName(javax.naming.Name)

linkExplanation

protected String linkExplanation

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

См. также:

getLinkExplanation(), setLinkExplanation(java.lang.String)

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

LinkException

public LinkException(String explanation)

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

Параметры:

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

См. также:

Throwable.getMessage()

LinkException

public LinkException()

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

Методы

getLinkResolvedName

public Name getLinkResolvedName()

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

Возвращает:

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

См. также:

getLinkResolvedObj(), setLinkResolvedName(javax.naming.Name)

getLinkRemainingName

public Name getLinkRemainingName()

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

Возвращает:

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

См. также:

setLinkRemainingName(javax.naming.Name)

getLinkResolvedObj

public Object getLinkResolvedObj()

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

Возвращает:

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

См. также:

getLinkResolvedName(), setLinkResolvedObj(java.lang.Object)

getLinkExplanation

public String getLinkExplanation()

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

Возвращает:

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

См. также:

setLinkExplanation(java.lang.String)

setLinkExplanation

public void setLinkExplanation(String msg)

Устанавливает объяснение, связанное с проблемой, возникшей при разрешении ссылки.

Параметры:

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

См. также:

getLinkExplanation()

setLinkResolvedName

public void setLinkResolvedName(Name name)

Параметры:

name - Имя, которое нужно установить для разрешенного имени ссылки. Может быть null. Если null, поле link resolved name устанавливается в null.

См. также:

getLinkResolvedName()

setLinkRemainingName

public void setLinkRemainingName(Name name)

Параметры:

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

См. также:

getLinkRemainingName()

setLinkResolvedObj

public void setLinkResolvedObj(Object obj)

Устанавливает поле объекта разрешенной ссылки для этого исключения. Это указывает на последний успешно разрешенный объект имени ссылки.

Параметры:

obj - Объект, который нужно установить для объекта разрешенной ссылки. Может быть null. Если null, поле link resolved object устанавливается в null.

См. также:

getLinkResolvedObj()

toString

public String toString()

Генерирует строковое представление этого исключения. Эта строка состоит из информации NamingException плюс оставшееся имя ссылки. Эта строка используется для отладки и не предназначена для программной интерпретации.

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

toString в классе NamingException

Возвращает:

Не null-строковое представление этого исключения ссылки.

toString

public String toString(boolean detail)

Генерирует строковое представление этого исключения. Эта строка состоит из информации NamingException плюс дополнительная информация о разрешении ссылки. Если 'detail' равно true, строка также содержит информацию об объекте разрешенной ссылки. Если false, этот метод эквивалентен форме toString(), которая не принимает параметров. Эта строка используется для отладки и не предназначена для программной интерпретации.

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

toString в классе NamingException

Параметры:

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

Возвращает:

Не null-строковое представление этого исключения ссылки.