Класс 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`	Содержит объект, к которому было успешно разрешено часть ссылки.

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

remainingName, resolvedName, resolvedObj, rootException

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

Конструктор	Описание
`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)`	Генерирует строковое представление этого исключения.

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

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

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

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

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

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

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

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 - Возможная пустая строка, содержащая дополнительные сведения об этом исключении.

См. также:

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, это означает, что для этого исключения нет сообщения об ошибке.

См. также:

setLinkExplanation

public void setLinkExplanation(String msg)

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

Параметры:

msg - Возможная пустая строка, более подробно объясняющая проблему с разрешением ссылки. Если 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.naming/javax/naming/LinkException.html