Класс StartTlsRequest

java.lang.Object
- javax.naming.ldap.StartTlsRequest

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

public class StartTlsRequest
extends Object
implements ExtendedRequest

Этот класс реализует расширенный запрос LDAPv3 для StartTLS, как определено в Lightweight Directory Access Protocol (v3): Extension for Transport Layer Security. Идентификатор объекта для 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
См. также:: StartTlsResponse, Сериализованная форма

Поля

Модификатор и тип	Поле	Описание
`static 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.

См. также:: Значения константных полей

Конструкторы

()

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(java.lang.String,byte[],int,int)

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 — Возможно null закодированное значение расширенного ответа в формате ASN.1 BER. Это сырые байты BER, включая тег и длину значения ответа. Она не включает идентификатор объекта ответа. Его значение игнорируется, так как от Start TLS ответа не ожидается наличия значения ответа.; offset — Начальная позиция в berValue для использования байтов. Ее значение игнорируется, так как от Start TLS ответа не ожидается наличия значения ответа.; length — Количество байтов в berValue для использования. Ее значение игнорируется, так как от Start TLS ответа не ожидается наличия значения ответа.
Возвращает:: Объект расширенного ответа StartTLS.
Исключения:: NamingException — Если при создании объекта расширенного ответа StartTLS возникло исключение при работе с именами.
См. также:: ExtendedResponse