Класс LinkException

Все реализованные интерфейсы:
Serializable
Прямые известные подклассы:
LinkLoopException, MalformedLinkException 
public class LinkException
extends NamingException

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

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

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

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

С тех пор:
1.3
См. также:
Context.lookupLink(javax.naming.Name), LinkRef, Сериализованная форма

Поля

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

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

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

Параметры:
name - Имя, которое нужно установить для поля имени разрешенной ссылки. Может быть null. Если null, поле имени разрешенной ссылки устанавливается в null.
См. также:
getLinkResolvedName()

setLinkRemainingName

public void setLinkRemainingName(Name name)

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

name является составным именем. Если цель установить это поле с помощью составного имени или строки, вы должны "преобразовать" составное имя в строку и создать составное имя с одним компонентом, используя эту строку. Затем вы можете вызвать этот метод с полученным составным именем.

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

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

setLinkResolvedObj

public void setLinkResolvedObj(Object obj)

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

Параметры:
obj - Объект, который нужно установить для объекта разрешенной ссылки. Может быть null. Если null, поле объекта разрешенной ссылки устанавливается в null.
См. также:
getLinkResolvedObj()

toString

public String toString()

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

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

toString

public String toString(boolean detail)

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

Переопределяет:
toString в классе NamingException
Параметры:
detail - Если true, добавить информацию об объекте разрешенной ссылки.
Возвращает:
Непустое строковое представление этого исключения ссылки.

© 1993, 2020, 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/11/docs/api/java.naming/javax/naming/LinkException.html

Spec-Zone .ru
спецификации, руководства, описания, API