Класс 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

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

Конструктор	Описание
`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

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

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

Методы, объявленные в классе 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, 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://docs.oracle.com/en/java/javase/25/docs/api/java.naming/javax/naming/LinkException.html