Spec-Zone.ru › OpenJDK 21

Класс LinkRef

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

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

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

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

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

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

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

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

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

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

addrs, classFactory, classFactoryLocation, className

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

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

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

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

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

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

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

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

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

LinkRef

public LinkRef(Name linkName)
Создаёт LinkRef для имени.
Параметры:
linkName - Непустое имя, для которого необходимо создать эту ссылку.

LinkRef

public LinkRef(String linkName)
Создаёт LinkRef для строкового имени.
Параметры:
linkName - Непустое имя, для которого необходимо создать эту ссылку.

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

getLinkName

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

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

Spec-Zone.ru

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