javax.naming.ldap

Интерфейсное Управление

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

Сериализуемый

Все Известные Классы с реализацией:

BasicControl, ManageReferralControl, PagedResultsControl, PagedResultsResponseControl, SortControl, SortResponseControl

public interface Control
extends Serializable

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

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

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

С тех пор:

1.3

См. Также:

ControlFactory

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

Поля

Модификатор и Тип	Поле и Описание
static boolean	КРИТИЧЕСКИЙ Указывает на критическое управление.
static boolean	НЕКРИТИЧЕСКИЙ Указывает на некритическое управление.

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

Методы

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

Полевая Деталь

КРИТИЧЕСКИЙ

static final boolean CRITICAL

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

См. Также:

Постоянные Значения полей

НЕКРИТИЧЕСКИЙ

static final boolean NONCRITICAL

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

См. Также:

Постоянные Значения полей

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

getID

String getID()

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

Возвраты:

Ненулевая объектная строка идентификатора.

isCritical

boolean isCritical()

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

Возвраты:

истина, если это управление является критическим; ложь иначе.

getEncodedValue

byte[] getEncodedValue()

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

Возвраты:

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