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

public interface Control
extends Serializable

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

Протокол LDAPv3 использует управления для отправки и получения дополнительных данных, чтобы повлиять на поведение предопределённых операций. Управления могут быть отправлены вместе с любой LDAP-операцией на сервер. Они называются управлениями запроса. Например, управление «сортировка» может быть отправлено с LDAP-операцией поиска, чтобы запросить, чтобы результаты возвращались в определённом порядке. Запрошенные и незапрошенные управления также могут возвращаться с ответами от сервера. Такие управления называются управлениями ответа. Например, 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()

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

Возвращает:

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