Spec-Zone.ru › OpenJDK 25

Класс LinkRef

java.lang.Object
javax.naming.Reference
javax.naming.LinkRef
Все реализуемые интерфейсы:
Serializable, Cloneable
public class LinkRef extends Reference
Этот класс представляет ссылку Reference, содержимое которой представляет собой имя, называемое именем ссылки и связанное с атомарным именем в контексте.

Имя является URL-адресом или именем, разрешаемым относительно начального контекста; если же первый символ имени — «.», имя является относительным к контексту, в котором связана ссылка.

При обычном разрешении имён в операциях с контекстом ссылки всегда переходят по ссылкам. Разрешение самого имени ссылки может привести к переходу через другие ссылки. Это создаёт возможность возникновения цикла ссылок, разрешение которого не может завершиться обычным образом. Чтобы избежать такого незавершающегося разрешения, поставщики служб могут ограничивать количество ссылок, участвующих в одной операции, вызванной вызывающей стороной.

LinkRef содержит один StringRefAddr, тип которого — "LinkAddress", а содержимое — имя ссылки. Поле имени класса в Reference содержит имя этого класса (LinkRef).

LinkRef связывается с именем с помощью обычных методов Context.bind()/rebind() и DirContext.bind()/rebind(). Метод Context.lookupLink() используется для получения самой ссылки, если конечное атомарное имя связано со ссылкой.

Многие системы именования поддерживают собственное понятие ссылки, которое может использоваться в самой системе именования. JNDI не определяет, существует ли какая-либо связь между такими собственными ссылками и ссылками JNDI.

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

Начиная с:
1.3
См. также:
  • LinkException
  • LinkLoopException
  • MalformedLinkException
  • Context.lookupLink(Name)
  • Сериализованная форма

Краткое описание полей

Поля, объявленные в классе Reference

addrs, classFactory, classFactoryLocation, className

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

Конструктор Описание
LinkRef(String linkName)
Создаёт LinkRef для строкового имени.
LinkRef(Name linkName)
Создаёт LinkRef для имени.

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

Модификатор и тип Метод Описание
String getLinkName()
Возвращает имя этой ссылки.

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

add, add, clear, clone, equals, get, get, getAll, getClassName, getFactoryClassLocation, getFactoryClassName, hashCode, remove, size, toString

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

finalize, getClass, notify, notifyAll, wait, wait, wait

Подробное описание конструкторов

LinkRef

public LinkRef(Name linkName)
Создаёт LinkRef для имени.
Параметры:
linkName — имя, не равное null, для которого создаётся эта ссылка.

LinkRef

public LinkRef(String linkName)
Создаёт LinkRef для строкового имени.
Параметры:
linkName — имя, не равное null, для которого создаётся эта ссылка.

Подробное описание методов

getLinkName

public String getLinkName() throws NamingException
Возвращает имя этой ссылки.
Возвращает:
Имя этой ссылки, не равное null.
Вызывает исключение:
MalformedLinkException — если имя ссылки не удалось извлечь
NamingException — если возникло исключение при работе с именованием.

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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/LinkRef.html

Spec-Zone.ru

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