Spec-Zone.ru › OpenJDK 21

Интерфейс ExtendedResponse

Все суперинтерфейсы:
Serializable
Все известные подинтерфейсы:
UnsolicitedNotification
Все известные реализующие классы:
StartTlsResponse
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();
С:
1.3
См. также:
  • ExtendedRequest

Краткое описание методов

Модификатор и тип Метод Описание
byte[] getEncodedValue()
Возвращает закодированное в ASN.1 BER значение ответа на расширенную операцию LDAP.
String getID()
Возвращает идентификатор объекта ответа.

Подробное описание методов

getID

String getID()
Возвращает идентификатор объекта ответа. Протокол LDAP определяет, что идентификатор объекта ответа является необязательным. Если сервер его не отправляет, в ответе не будет ID (т.е. null).
Возвращает:
Возможная строка идентификатора объекта, представляющая компонент LDAP ExtendedResponse.responseName. Может быть null.

getEncodedValue

byte[] getEncodedValue()
Возвращает закодированное в ASN.1 BER значение ответа на расширенную операцию LDAP. Возвращает null, если значение отсутствует в ответе, отправленном сервером LDAP. Результатом является сырой массив байтов BER, включая тег и длину значения ответа. Он не включает в себя OID ответа.
Возвращает:
Возможный массив байтов, представляющий закодированное в ASN.1 BER содержимое компонента LDAP ExtendedResponse.response. Может быть null.

© 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/ExtendedResponse.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API