Класс LinkException

javax.naming.LinkException

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

Прямые известные подклассы:: LinkLoopException, MalformedLinkException

public class LinkException extends NamingException

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

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

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

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

Начиная с:

1.3

См. также:

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

Модификатор и тип	Поле	Описание
`protected String`	`linkExplanation`	Содержит исключение, объясняющее, почему разрешение ссылки завершилось неудачей.
`protected Name`	`linkRemainingName`	Содержит ещё не разрешённую часть имени ссылки.
`protected Name`	`linkResolvedName`	Содержит часть ссылки, разрешённую успешно.
`protected Object`	`linkResolvedObj`	Содержит объект, до которого успешно выполнено разрешение части ссылки.

Поля, объявленные в классе NamingException

remainingName, resolvedName, resolvedObj, rootException

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

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

Конструктор	Описание
`LinkException()`	Создаёт новый экземпляр LinkException.
`LinkException(String explanation)`	Создаёт новый экземпляр LinkException с пояснением.

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

Модификатор и тип	Метод	Описание
`String`	`getLinkExplanation()`	Возвращает пояснение, связанное с проблемой, возникшей при разрешении ссылки.
`Name`	`getLinkRemainingName()`	Возвращает оставшуюся неразрешённую часть имени ссылки.
`Name`	`getLinkResolvedName()`	Возвращает начальную часть имени ссылки, разрешённую успешно.
`Object`	`getLinkResolvedObj()`	Возвращает объект, до которого успешно выполнено разрешение.
`void`	`setLinkExplanation(String msg)`	Задаёт пояснение, связанное с проблемой, возникшей при разрешении ссылки.
`void`	`setLinkRemainingName(Name name)`	Задаёт поле оставшегося имени ссылки этого исключения.
`void`	`setLinkResolvedName(Name name)`	Задаёт поле разрешённого имени ссылки этого исключения.
`void`	`setLinkResolvedObj(Object obj)`	Задаёт поле разрешённого объекта ссылки этого исключения.
`String`	`toString()`	Формирует строковое представление этого исключения.
`String`	`toString(boolean detail)`	Формирует строковое представление этого исключения.

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

appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause

Модификатор и тип	Метод	Описание
`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.

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

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

Модификатор и тип	Метод	Описание
`final void`	`addSuppressed(Throwable exception)`	Добавляет указанное исключение к исключениям, которые были подавлены, чтобы выдать это исключение.
`Throwable`	`fillInStackTrace()`	Заполняет трассировку стека вызовов.
`String`	`getLocalizedMessage()`	Создаёт локализованное описание этого объекта-исключения.
`String`	`getMessage()`	Возвращает строку подробного сообщения этого объекта-исключения.
`StackTraceElement[]`	`getStackTrace()`	Предоставляет программный доступ к информации о трассировке стека, выводимой методом `Throwable.printStackTrace()`.
`final Throwable[]`	`getSuppressed()`	Возвращает массив, содержащий все исключения, которые были подавлены, обычно оператором `try`-with-resources, чтобы выдать это исключение.
`void`	`printStackTrace()`	Выводит это исключение и его трассировку стека в стандартный поток ошибок.
`void`	`printStackTrace(PrintStream s)`	Выводит это исключение и его трассировку стека в указанный поток печати.
`void`	`printStackTrace(PrintWriter s)`	Выводит это исключение и его трассировку стека в указанный объект печати.
`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, либо истечения определённого промежутка реального времени.

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

linkResolvedName

protected Name linkResolvedName

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

См. также:

linkResolvedObj

protected Object linkResolvedObj

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

См. также:

linkRemainingName

protected Name linkRemainingName

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

См. также:

linkExplanation

protected String linkExplanation

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

См. также:

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

LinkException

public LinkException(String explanation)

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

Параметры:

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

См. также:

LinkException

public LinkException()

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

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

getLinkResolvedName

public Name getLinkResolvedName()

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

Возвращает:

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

См. также:

getLinkRemainingName

public Name getLinkRemainingName()

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

Возвращает:

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

См. также:

getLinkResolvedObj

public Object getLinkResolvedObj()

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

Возвращает:

Объект, разрешённый на текущий момент; он может иметь значение null. Если значение равно null, это означает, что поле разрешённого объекта ссылки не задано.

См. также:

getLinkExplanation

public String getLinkExplanation()

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

Возвращает:

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

См. также:

setLinkExplanation

public void setLinkExplanation(String msg)

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

Параметры:

msg — строка с подробностями, объясняющими проблему разрешения ссылки; она может иметь значение null. Если значение равно null, подробности не сохраняются.

См. также:

setLinkResolvedName

public void setLinkResolvedName(Name name)

Задаёт поле разрешённого имени ссылки этого исключения.

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

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

Параметры:

name — имя, которое следует задать в качестве разрешённого имени ссылки. Может иметь значение null. Если значение равно null, поле разрешённого имени ссылки устанавливается в null.

См. также:

setLinkRemainingName

public void setLinkRemainingName(Name name)

Задаёт поле оставшегося имени ссылки этого исключения.

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

Параметры:

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

См. также:

setLinkResolvedObj

public void setLinkResolvedObj(Object obj)

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

Параметры:

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

См. также:

toString

public String toString()

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

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

toString

public String toString(boolean detail)

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

Переопределяет:: toString в классе NamingException
Параметры:: 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.