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

Все суперинтерфейсы:: 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, если значение отсутствует.

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

© 1993, 2023, 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/21/docs/api/java.naming/javax/naming/ldap/Control.html