Интерфейс ExtendedRequest

public interface ExtendedRequest
extends Serializable

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

ExtendedRequest ::= [APPLICATION 23] SEQUENCE {
              requestName      [0] LDAPOID,
              requestValue     [1] OCTET STRING OPTIONAL }

Он состоит из строки идентификатора объекта и необязательного закодированного значения ASN.1 BER.

Методы в этом классе используются поставщиком сервиса для построения битов, которые будут отправлены на сервер LDAP. Приложения обычно взаимодействуют только с классами, реализующими этот интерфейс, предоставляя им необходимую информацию для конкретного запроса расширенной операции. Затем они передают такой класс в качестве аргумента методу LdapContext.extendedOperation() для выполнения расширенной операции LDAPv3.

Например, предположим, что сервер LDAP поддерживает расширенную операцию «получение времени». Он предоставит классы GetTimeRequest и GetTimeResponse:

public class GetTimeRequest implements ExtendedRequest {
    public GetTimeRequest() {... };
    public ExtendedResponse createExtendedResponse(String id,
        byte[] berValue, int offset, int length)
        throws NamingException {
        return new GetTimeResponse(id, berValue, offset, length);
    }
    ...
}
public class GetTimeResponse implements ExtendedResponse {
    long time;
    public GetTimeResponse(String id, byte[] berValue, int offset,
        int length) throws NamingException {
        time =      ... // decode berValue to get time
    }
    public java.util.Date getDate() { return new java.util.Date(time) };
    public long getTime() { return time };
    ...
}

Программа будет использовать эти классы следующим образом:

GetTimeResponse resp =
    (GetTimeResponse) ectx.extendedOperation(new GetTimeRequest());
long time = resp.getTime();

Методы

getID

String getID()

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

Возвращает:

Строку идентификатора объекта, представляющую компонент LDAP ExtendedRequest.requestName. Она не может быть null.

getEncodedValue

byte[] getEncodedValue()

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

Возвращает:

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

Исключение:

IllegalStateException - Если закодированное значение не может быть получено из-за недостаточности или некорректности данных/состояния запроса.

createExtendedResponse

ExtendedResponse createExtendedResponse(String id,
                                        byte[] berValue,
                                        int offset,
                                        int length)
                                 throws NamingException

Параметры:

id - Возможный идентификатор объекта ответа в виде строки.

berValue - Возможное закодированное значение ASN.1 BER ответа в виде массива байтов. Это массив байтов BER, включая тег и длину значения ответа. Он не включает OID ответа.

offset - Начальная позиция в berValue для использования байтов.

length - Количество байтов в berValue для использования.

Возвращает:

Не-null объект.

Исключение:

NamingException - Если создание расширенного ответа невозможно из-за ошибки.

См. также:

ExtendedResponse