Spec-Zone.ru › OpenJDK 17

Интерфейс 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, 2021, 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/17/docs/api/java.naming/javax/naming/ldap/ExtendedResponse.html

Spec-Zone.ru

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