Интерфейс DirStateFactory

public interface DirStateFactory
extends StateFactory

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

Фреймворк JNDI позволяет загружать реализации объектов динамически с помощью object factories.

Класс DirStateFactory расширяет StateFactory, позволяя передавать и возвращать экземпляр Attributes в метод getStateToBind(). Реализации DirStateFactory предназначены для использования поставщиками DirContext сервисов. Когда вызывающая сторона привязывает объект, используя DirContext.bind(), она может также указать набор атрибутов, которые необходимо привязать к объекту. Объект и атрибуты, которые нужно привязать, передаются в метод getStateToBind() фабрики. Если фабрика обрабатывает объект и атрибуты, она возвращает соответствующую пару объект-атрибуты для привязки. Если фабрика не обрабатывает объект, она должна вернуть null.

Например, вызывающая сторона может привязать объект принтера с некоторыми связанными с принтером атрибутами.

ctx.rebind("inky", printer, printerAttrs);

Поставщик LDAP-сервиса для ctx использует класс DirStateFactory (косвенно через DirectoryManager.getStateToBind()) и предоставляет ему printer и printerAttrs. Фабрика для LDAP-каталога может преобразовать printer в набор атрибутов и объединить его с printerAttrs. Затем поставщик сервиса использует полученные атрибуты для создания записи LDAP и обновляет каталог.

Поскольку DirStateFactory расширяет StateFactory, у него есть два метода getStateToBind(), где один отличается от другого аргументом attributes. DirectoryManager.getStateToBind() будет использовать только форму, принимающую аргумент attributes, в то время как NamingManager.getStateToBind() будет использовать только форму, не принимающую аргумент attributes.

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

Методы

getStateToBind

DirStateFactory.Result getStateToBind(Object obj,
                                      Name name,
                                      Context nameCtx,
                                      Hashtable<?,?> environment,
                                      Attributes inAttrs)
                               throws NamingException

Параметры:

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

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

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

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

inAttrs - Возможно нулевые атрибуты, которые необходимо привязать к объекту. Фабрика не должна изменять inAttrs.

Возвращает:

Объект Result, содержащий состояние объекта для привязки и соответствующие атрибуты для привязки; null, если объект не использует эту фабрику.

Бросает:

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

См. также:

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