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

Все суперинтерфейсы:: 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-контроля.

Возвращает:: Непустую строку идентификатора объекта.

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://download.java.net/java/early_access/jdk24/docs/api/java.naming/javax/naming/ldap/Control.html