Класс StartTlsRequest

java.lang.Object

javax.naming.ldap.StartTlsRequest

Все реализуемые интерфейсы:: Serializable, ExtendedRequest

public class StartTlsRequest extends Object implements ExtendedRequest

Этот класс реализует расширенный запрос LDAPv3 для StartTLS, как определено в Протокол доступа к лёгким каталогам (v3): Расширение для безопасности транспортного уровня Идентификатор объекта для StartTLS — 1.3.6.1.4.1.1466.20037, и значение расширенного запроса не определено.

StartTlsRequest/StartTlsResponse используются для установления TLS-соединения по существующему LDAP-соединению, связанному с контекстом JNDI, в котором вызывается extendedOperation(). Как правило, программа JNDI использует эти классы следующим образом.

 import javax.naming.ldap.*;

 // Open an LDAP association
 LdapContext ctx = new InitialLdapContext();

 // Perform a StartTLS extended operation
 StartTlsResponse tls =
     (StartTlsResponse) ctx.extendedOperation(new StartTlsRequest());

 // Open a TLS connection (over the existing LDAP association) and get details
 // of the negotiated TLS session: cipher suite, peer certificate, etc.
 SSLSession session = tls.negotiate();

 // ... use ctx to perform protected LDAP operations

 // Close the TLS connection (revert back to the underlying LDAP association)
 tls.close();

 // ... use ctx to perform unprotected LDAP operations

 // Close the LDAP association
 ctx.close;

С:

1.4

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final String`	`OID`	Присвоенный идентификатор объекта расширенного запроса StartTLS — 1.3.6.1.4.1.1466.20037.

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

Конструктор	Описание
`StartTlsRequest()`	Создаёт расширенный запрос StartTLS.

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

Модификатор и тип	Метод	Описание
`ExtendedResponse`	`createExtendedResponse(String id, byte[] berValue, int offset, int length)`	Создаёт объект расширенного ответа, соответствующий расширенному запросу LDAP StartTLS.
`byte[]`	`getEncodedValue()`	Извлекает закодированное значение запроса StartTLS в формате ASN.1 BER.
`String`	`getID()`	Извлекает строку идентификатора объекта запроса StartTLS.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

OID

public static final String OID

Присвоенный идентификатор объекта расширенного запроса StartTLS — 1.3.6.1.4.1.1466.20037.

См. также:

Значения константных полей

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

StartTlsRequest

public StartTlsRequest()

Создаёт расширенный запрос StartTLS.

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

getID

public String getID()

Извлекает строку идентификатора объекта запроса StartTLS.

Унаследовано от:: getID в интерфейсе ExtendedRequest
Возвращает:: Строка идентификатора объекта, "1.3.6.1.4.1.1466.20037".

getEncodedValue

public byte[] getEncodedValue()

Извлекает закодированное значение запроса StartTLS в формате ASN.1 BER. Поскольку для запроса не определено значение, всегда возвращается null.

Унаследовано от:: getEncodedValue в интерфейсе ExtendedRequest
Возвращает:: Значение null.

createExtendedResponse

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

Создаёт объект расширенного ответа, соответствующий расширенному запросу LDAP StartTLS.

Результат должен быть конкретным подклассом StartTlsResponse и должен иметь публичный конструктор без аргументов.

Этот метод ищет реализацию, находя конфигурационные файлы с именем:

META-INF/services/javax.naming.ldap.StartTlsResponse

Конфигурационные файлы и соответствующие реализующие классы должны быть доступны загрузчику классов контекста вызывающей нити.

Каждый конфигурационный файл должен содержать список полных имён классов, по одному на строке. Пробелы и символы табуляции вокруг каждого имени, а также пустые строки игнорируются. Символ комментария — '#' (0x23); в каждой строке все символы после первого символа комментария игнорируются. Файл должен быть закодирован в UTF-8.

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

Если ни один класс не может быть найден таким образом, этот метод воспользуется способом поиска реализации, специфичным для реализации. Если таковой не будет найден, будет брошено исключение NamingException.

Унаследовано от:

createExtendedResponse в интерфейсе ExtendedRequest

Параметры:

id - Идентификатор объекта расширенного ответа. Его значение должно быть "1.3.6.1.4.1.1466.20037" или null. Оба значения эквивалентны.

berValue - Возможно, нулевое закодированное значение расширенного ответа в формате ASN.1 BER. Это сырые байты BER, включая тег и длину значения ответа. Оно не включает идентификатор объекта ответа. Его значение игнорируется, поскольку от ответа Start TLS не ожидается наличие значения ответа.

offset - Начальная позиция в berValue байтов для использования. Его значение игнорируется, поскольку от ответа Start TLS не ожидается наличие значения ответа.

length - Количество байтов в berValue для использования. Его значение игнорируется, поскольку от ответа Start TLS не ожидается наличие значения ответа.

Возвращает:

Объект расширенного ответа StartTLS.

Исключения:

NamingException - Если при создании объекта расширенного ответа StartTLS возникло исключение именования.

См. также:

ExtendedResponse

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