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

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

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

public interface Control extends Serializable

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

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

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

С:

1.3

См. также:

ControlFactory

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

Модификатор и тип	Поле	Описание
`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, 2021, 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/17/docs/api/java.naming/javax/naming/ldap/Control.html