Spec-Zone.ru › OpenJDK 25

Интерфейс 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()
Получает значение ответа на расширенную операцию LDAP в кодировке ASN.1 BER.
String getID()
Получает идентификатор объекта ответа.

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

getID

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

getEncodedValue

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

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.naming/javax/naming/ldap/ExtendedResponse.html

Spec-Zone.ru

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