Класс 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, 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