Класс 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 для имени.

Методы

Модификатор и типМетодОписание
StringgetLinkName()

Возвращает имя этой ссылки.

Методы, объявленные в классе 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, 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/LinkRef.html

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