javax.naming.spi

Класс DirectoryManager

java.lang. Объект

javax.naming.spi. NamingManager

javax.naming.spi. DirectoryManager

public class DirectoryManager
extends NamingManager

Этот класс содержит методы для того, чтобы поддерживать реализации DirContext.

Этот класс является расширением NamingManager. Это содержит методы для использования поставщиками услуг для того, чтобы получить доступ к объектным фабрикам и фабрикам состояния, и для того, чтобы получить контексты продолжения для того, чтобы они поддерживали федерацию.

DirectoryManager безопасен для параллельного доступа многократными потоками.

Если не указано иное Name, Attributes, или параметр среды, который передают к любому методу, принадлежат вызывающей стороне. Реализация не будет изменять объект или сохранять ссылку на него, хотя он может сохранить ссылку на клона или копию.

С тех пор:

1.3

См. Также:

DirObjectFactory, DirStateFactory

Полевая Сводка

Поля javax.naming.spi унаследованный от класса. NamingManager

CPE

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
static DirContext	getContinuationDirContext(CannotProceedException cpe) Создает контекст, в котором можно продолжать работу DirContext.
static Object	getObjectInstance(Object refInfo, Name name, Context nameCtx, Hashtable<?,?> environment, Attributes attrs) Создает экземпляр объекта для указанного объекта, атрибутов, и среды.
static DirStateFactory.Result	getStateToBind(Object obj, Name name, Context nameCtx, Hashtable<?,?> environment, Attributes attrs) Получает состояние объекта для того, чтобы связать когда дано исходный объект и его атрибуты.

Методы javax.naming.spi унаследованный от класса. NamingManager

getContinuationContext, getInitialContext, getObjectInstance, getStateToBind, getURLContext, hasInitialContextFactoryBuilder, setInitialContextFactoryBuilder, setObjectFactoryBuilder

Методы java.lang унаследованный от класса. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь метода

getContinuationDirContext

public static DirContext getContinuationDirContext(CannotProceedException cpe)
                                            throws NamingException

Создает контекст, в котором можно продолжать работу DirContext. Работает точно так же как NamingManager.getContinuationContext() только возвращенным контекстом продолжения является DirContext.

Параметры:

cpe - Ненулевое исключение, которое инициировало это продолжение.

Возвраты:

Ненулевой DirContext возражает для того, чтобы продолжать работу.

Броски:

NamingException - Если исключение именования произошло.

См. Также:

NamingManager.getContinuationContext(CannotProceedException)

getObjectInstance

public static Object getObjectInstance(Object refInfo,
                       Name name,
                       Context nameCtx,
                       Hashtable<?,?> environment,
                       Attributes attrs)
                                throws Exception

Создает экземпляр объекта для указанного объекта, атрибутов, и среды.

Этот метод является тем же самым как NamingManager.getObjectInstance за исключением следующих различий:

• Это принимает параметр Attributes, который содержит атрибуты, связанные с объектом. DirObjectFactory мог бы использовать эти атрибуты, чтобы сохранить необходимость искать их из каталога.
• Объектные фабрики, которые попробовали, должны реализовать или ObjectFactory или DirObjectFactory. Если это реализует DirObjectFactory, DirObjectFactory.getObjectInstance() используется, иначе, ObjectFactory.getObjectInstance() используется.

Поставщики услуг, которые реализуют интерфейс DirContext, должны использовать этот метод, не NamingManager.getObjectInstance().

Параметры:

refInfo - Возможно нулевой объект, для которого можно создать объект.

name - Имя этого объекта относительно nameCtx. Определение имени является дополнительным; если это опускается, name должен быть нуль.

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

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

attrs - Возможно неопределенные атрибуты связались с refInfo. Это не могло бы быть полным набором атрибутов для refInfo; Вы могли бы быть в состоянии считать больше атрибутов из каталога.

Возвраты:

Объект создал использование refInfo и attrs; или refInfo если объект не может быть создан фабрикой.

Броски:

NamingException - Если с исключением именования встретились, пытаясь получить контекст URL, или если одна из фабрик броски, к которым получают доступ, NamingException.

Exception - Если одна из фабрик, к которым получают доступ, выдает исключение, или если с ошибкой встретились, загружаясь и инстанцируя фабрики и классов объектов. Фабрика должна только выдать исключение, если она не хочет, чтобы другие фабрики использовались в попытке создать объект. См. DirObjectFactory.getObjectInstance().

С тех пор:

1.3

См. Также:

NamingManager.getURLContext(java.lang.String, java.util.Hashtable<?, ?>), DirObjectFactory, DirObjectFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>, javax.naming.directory.Attributes)

getStateToBind

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

Получает состояние объекта для того, чтобы связать когда дано исходный объект и его атрибуты.

Этот метод походит на NamingManager.getStateToBind за исключением следующих различий:

• Это принимает параметр Attributes, содержащий атрибуты, которые передали к методу DirContext.bind().
• Это возвращает ненулевой экземпляр DirStateFactory.Result, содержащий объект, который будет связан, и атрибуты, чтобы сопровождать привязку. Или объект или атрибуты могут быть нулем.
• Фабрики состояния, которые попробовали, должны каждый реализовать или StateFactory или DirStateFactory. Если это реализует DirStateFactory, то DirStateFactory.getStateToBind() вызывают; иначе, StateFactory.getStateToBind() вызывают.

Поставщики услуг, которые реализуют интерфейс DirContext, должны использовать этот метод, не NamingManager.getStateToBind().

См. NamingManager.getStateToBind () для описания того, как список фабрик состояния, которые попробуют, определяется.

Объект, возвращенный этим методом, принадлежит вызывающей стороне. Реализация не будет впоследствии изменять это. Это будет содержать или новый объект Attributes, который аналогично принадлежит вызывающей стороне, или ссылке на исходный параметр attrs.

Параметры:

obj - Ненулевой объект, для которого можно заставить состояние связывать.

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

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

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

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

Возвраты:

Ненулевой DirStateFactory. Результат, содержащий объект и атрибуты, которые будут связаны. Если никакая фабрика состояния не даст ненулевой ответ, то результат будет содержать объект (obj) непосредственно с исходными атрибутами.

Броски:

NamingException - Если с исключением именования встретились, используя фабрики. Фабрика должна только выдать исключение, если она не хочет, чтобы другие фабрики использовались в попытке создать объект. См. DirStateFactory.getStateToBind().

С тех пор:

1.3

См. Также:

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