javax.naming.ldap

Класс ControlFactory

java.lang. Объект

javax.naming.ldap. ControlFactory

public abstract class ControlFactory
extends Object

Этот абстрактный класс представляет фабрику для того, чтобы создать средства управления LDAPv3. Средства управления LDAPv3 определяются в RFC 2251.

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

С тех пор:

1.3

См. Также:

Control

Сводка конструктора

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

Модификатор	Конструктор и Описание
protected	ControlFactory()

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

Методы

Модификатор и Тип	Метод и Описание
abstract Control	getControlInstance(Control ctl) Создает управление, используя эту фабрику управления.
static Control	getControlInstance(Control ctl, Context ctx, Hashtable<?,?> env) Создает управление, используя известные фабрики управления.

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

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

Деталь конструктора

ControlFactory

protected ControlFactory()

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

getControlInstance

public abstract Control getControlInstance(Control ctl)
                                    throws NamingException

Создает управление, используя эту фабрику управления.

Фабрика используется поставщиком услуг, чтобы возвратить средства управления, которые она читает из протокола LDAP как специализированные классы управления. Без этого механизма провайдер возвратил бы средства управления, которые только содержали данные в BER закодированный формат.

Как правило, ctl является "основным" управлением, содержащим BER закодированные данные. Фабрика используется, чтобы создать специализированную реализацию управления, обычно декодируя BER закодированные данные, которые обеспечивают методы, чтобы получить доступ к тем данным безопасным с точки зрения типов и дружественным способом.

Например, фабрика могла бы использовать BER закодированные данные в основном управлении и возвратить экземпляр VirtualListReplyControl.

Если эта фабрика не может создать управление, используя предоставленный параметр, это должно возвратить нуль. Фабрика должна только выдать исключение, если это уверено, что это - единственная намеченная фабрика и что никакие другие фабрики управления нельзя попробовать. Это могло бы произойти, например, если данные BER в управлении не соответствуют то, что ожидается управления с данным OID. Так как этот метод бросает NamingException, любое другое внутренне сгенерированное исключение, которое должно быть распространено, должно быть обернуто в NamingException.

Параметры:

ctl - Ненулевое управление.

Возвраты:

Возможно нулевое Управление.

Броски:

NamingException - Если ctl содержит недопустимые данные, которые препятствуют тому, чтобы он имелся обыкновение создавать управление. Фабрика должна только выдать исключение, если она знает, как произвести управление (идентифицированный OID), но неспособна к из-за, например недопустимые данные BER.

getControlInstance

public static Control getControlInstance(Control ctl,
                         Context ctx,
                         Hashtable<?,?> env)
                                  throws NamingException

Создает управление, используя известные фабрики управления.

Следующее правило используется, чтобы создать управление:

• Используйте фабрики управления, определенные в свойстве LdapContext.CONTROL_FACTORIES среды, и файла ресурсов провайдера, связанного с ctx, в том порядке. Значение этого свойства является разделенным от двоеточия списком имен классов фабрики, которые пробуют в порядке, и первый, который преуспевает в том, чтобы создать управление, является используемым тем. Если ни одна из фабрик не может быть загружена, возвратиться ctl. Если с исключением встречаются, создавая управление, исключение передают до вызывающей стороны.

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

Параметры:

ctl - Ненулевой объект управления, содержащий OID и данные BER.

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

env - Возможно нулевая среда контекста. Это используется, чтобы найти значение свойства LdapContext.CONTROL_FACTORIES.

Возвраты:

Объект управления создал использование ctl; или ctl если объект управления не может быть создан, используя алгоритм, описанный выше.

Броски:

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