Spec-Zone.ru › OpenJDK 17

Класс LinkException

java.lang.Object
java.lang.Throwable
java.lang.Exception
javax.naming.NamingException
javax.naming.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, устанавливает поле linkResolvedName в 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' истинно, строка также содержит информацию об объекте разрешённой ссылки. Если ложно, этот метод такой же, как форма toString(), которая не принимает параметров. Эта строка предназначена для отладки и не должна интерпретироваться программно.
Переопределяет:
toString в классе NamingException
Параметры:
detail - Если истинно, добавить информацию об объекте разрешённой ссылки.
Возвращает:
Строковое представление этого исключения ссылки.

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API