Интерфейс управления

Все суперинтерфейсы:: Serializable

Все известные реализующие классы:: BasicControl, ManageReferralControl, PagedResultsControl, PagedResultsResponseControl, SortControl, SortResponseControl

public interface Control
extends Serializable

Этот интерфейс представляет собой LDAPv3-контроль, как определено в RFC 2251.

Протокол LDAPv3 использует контроллеры для отправки и получения дополнительных данных, влияющих на поведение предварительно определённых операций. Контроллеры могут быть отправлены вместе с любой операцией LDAP на сервер. Они называются контроллерами запроса. Например, контроллер "сортировки" может быть отправлен вместе с операцией поиска LDAP для запроса возврата результатов в определённом порядке. Подтверждённые и неподтверждённые контроллеры также могут быть возвращены с ответами от сервера. Такие контроллеры называются контроллерами ответа. Например, сервер LDAP может определить специальный контроллер для возврата уведомлений о изменениях.

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

С:: 1.3
См. также:: ControlFactory

Поля

Модификатор и тип	Поле	Описание
`static boolean`	`CRITICAL`	Указывает на критический контроль.
`static boolean`	`NONCRITICAL`	Указывает на некритический контроль.

Методы

Модификатор и тип	Метод	Описание
`byte[]`	`getEncodedValue()`	Получает закодированное значение LDAP-контроллера в ASN.1 BER.
`String`	`getID()`	Получает идентификатор объекта, назначенный для LDAP-контроллера.
`boolean`	`isCritical()`	Определяет критичность LDAP-контроллера.

Поля

CRITICAL

static final boolean CRITICAL

Указывает на критический контроль. Значение этой константы true.

См. также:: Значения константных полей

NONCRITICAL

static final boolean NONCRITICAL

Указывает на некритический контроль. Значение этой константы false.

См. также:: Значения константных полей

Методы

getID

String getID()

Получает идентификатор объекта, назначенный для LDAP-контроллера.

Возвращает:: Строка идентификатора объекта, не равная null.

isCritical

boolean isCritical()

Определяет критичность LDAP-контроллера. Критический контроль не должен игнорироваться сервером. Другими словами, если сервер получает критический контроль, который он не поддерживает, независимо от того, имеет ли смысл контроль для операции, операция не будет выполнена, и будет брошено исключение OperationNotSupportedException.

Возвращает:: true, если данный контроль является критическим; false в противном случае.

getEncodedValue

byte[] getEncodedValue()

Получает закодированное значение LDAP-контроллера в ASN.1 BER. Результат — сырые байты BER, включая тег и длину значения контроллера. Он не включает OID или критичность контроллера. Возвращает null, если значение отсутствует.

Возвращает:: Возможный массив байтов null, представляющий ASN.1 BER закодированное значение LDAP-контроллера.