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

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

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

public interface Control extends Serializable

Этот интерфейс представляет элемент управления LDAPv3, определённый в RFC 2251.

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

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

Начиная с версии:

1.3

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final boolean`	`CRITICAL`	Указывает на критический элемент управления.
`static final 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 и представляет значение элемента управления LDAP в кодировке ASN.1 BER.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.naming/javax/naming/ldap/Control.html