Интерфейс StateFactory

public interface StateFactory

Данный интерфейс представляет собой фабрику для получения состояния объекта для связывания.

Фреймворк JNDI позволяет динамически загружать реализации объектов через объектные фабрики. Например, при поиске принтера, связанного в пространстве имён, если служба печати связывает имена принтеров с References, то принтер Reference может быть использован для создания объекта принтера, так что вызывающий метод lookup может напрямую работать с объектом принтера после поиска.

ObjectFactory отвечает за создание объектов определённого типа. В приведённом выше примере может быть PrinterObjectFactory для создания Printer объектов.

Для обратного процесса, когда объект связывается в пространство имён, JNDI предоставляет фабрики состояния. Продолжая пример с принтером, предположим, что объект принтера обновлён и пересвязан:

ctx.rebind("inky", printer);

Поставщик услуг для ctx использует фабрику состояния для получения состояния printer для связывания в его пространство имён. Фабрика состояния для объекта типа Printer может возвращать более компактный объект для хранения в системе имён.

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

Метод getStateToBind() фабрики состояния может вызываться многократно, возможно, с использованием различных параметров. Реализация потокобезопасна.

StateFactory предназначен для использования с поставщиками услуг, реализующими только интерфейс Context. DirStateFactory предназначен для использования с поставщиками услуг, реализующими интерфейс DirContext.

Методы

getStateToBind

Object getStateToBind(Object obj,
                      Name name,
                      Context nameCtx,
                      Hashtable<?,?> environment)
               throws NamingException

Параметры:

obj - Не нулевой объект, состояние которого необходимо получить.

name - Имя этого объекта относительно nameCtx, или null, если имя не указано.

nameCtx - Контекст относительно которого указан параметр name, или null, если name относится к контексту по умолчанию.

environment - Возможно null окружение, используемое при создании состояния объекта.

Возвращает:

Состояние объекта для связывания; null, если фабрика не возвращает изменений.

Исключения:

NamingException - если эта фабрика столкнулась с исключением при попытке получить состояние объекта, и другие фабрики не должны пробоваться.

См. также:

NamingManager.getStateToBind(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>), DirectoryManager.getStateToBind(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>, javax.naming.directory.Attributes)