Класс DirectoryManager

Этот класс содержит методы для поддержки DirContext реализаций.

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

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

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

Подробности методов

getContinuationDirContext

public static DirContext getContinuationDirContext(CannotProceedException cpe)
                                            throws NamingException

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

Параметры:

cpe - исключение, не равное null, которое вызвало это продолжение.

Возвращает:

Объект DirContext для продолжения операции, не равный null.

Исключения:

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

См. также:

NamingManager.getContinuationContext(CannotProceedException)

getObjectInstance

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

Параметры:

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

name - имя этого объекта относительно nameCtx. Указание имени необязательно; если оно опущено, то name должно быть null.

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

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

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

Возвращает:

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

Исключения:

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

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

Since:

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

Параметры:

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

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

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

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

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

Возвращает:

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

Исключения:

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

Since:

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<?, ?>)