Класс LinkRef

public class LinkRef
extends Reference

Этот класс представляет ссылку, содержимое которой — имя, называемое именем ссылки, привязанное к атомарному имени в контексте.

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

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

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

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

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

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

Конструкторы

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 - Если возникло исключение именования.