Класс 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 - Возможная строка 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, 2023, 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://docs.oracle.com/en/java/javase/21/docs/api/java.naming/javax/naming/LinkException.html