Интерфейс ExtendedResponse

public interface ExtendedResponse
extends Serializable

Этот интерфейс представляет собой ответ на расширенную операцию LDAP, как определено в RFC 2251.

ExtendedResponse ::= [APPLICATION 24] SEQUENCE {
          COMPONENTS OF LDAPResult,
          responseName     [10] LDAPOID OPTIONAL,
          response         [11] OCTET STRING OPTIONAL }

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

Методы в этом классе могут использоваться приложением для получения низкоуровневой информации о ответе расширенной операции. Однако, обычно, приложение будет использовать методы, специфичные для класса, реализующего этот интерфейс. Такой класс должен декодировать буфер BER в ответе и должен предоставить методы, позволяющие пользователю получить доступ к этим данным в ответе безопасным и удобным способом.

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

public class GetTimeResponse implements ExtendedResponse {
    public java.util.Date getDate() {...};
    public long getTime() {...};
    ....
}

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

GetTimeResponse resp =
    (GetTimeResponse) ectx.extendedOperation(new GetTimeRequest());
java.util.Date now = resp.getDate();

Методы

getID

String getID()

Получает идентификатор объекта ответа. Протокол LDAP указывает, что идентификатор объекта ответа является необязательным. Если сервер не отправляет его, ответ не будет содержать ID (т.е. null).

Возвращает:

Возможная строка идентификатора объекта, представляющая компонент LDAP ExtendedResponse.responseName.

getEncodedValue

byte[] getEncodedValue()

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

Возвращает:

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