Spec-Zone.ru › OpenJDK 17

Класс 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 - Не являющееся null именем, для которого создаётся эта ссылка.

LinkRef

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

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

getLinkName

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

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

Spec-Zone.ru

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