Spec-Zone .ru
спецификации, руководства, описания, API
|
public class StartTlsRequest extends Object implements ExtendedRequest
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;
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)
Создает расширенный объект ответа, который соответствует StartTLS LDAP расширенный запрос.
|
byte[] |
getEncodedValue()
Получает BER запроса StartTLS ASN.1 закодированное значение.
|
Строка |
getID()
Получает объектную строку идентификатора запроса StartTLS.
|
public static final String OID
public String getID()
getID
в интерфейсе ExtendedRequest
public byte[] getEncodedValue()
getEncodedValue
в интерфейсе ExtendedRequest
public ExtendedResponse createExtendedResponse(String id, byte[] berValue, int offset, int length) throws NamingException
Результат должен быть конкретным подклассом StartTlsResponse и должен иметь общедоступного конструктора нулевого параметра.
Этот метод определяет местоположение реализации class, определяя местоположение конфигурационных файлов, у которых есть имя:
META-INF/services/javax.naming.ldap.StartTlsResponseКонфигурационные файлы и их соответствующие классы реализации должны быть доступными для контекста вызывающего потока загрузчик class.
Каждый конфигурационный файл должен содержать список полностью определенных имен class, один на строку. Пространство и символы вкладки, окружающие каждое имя, так же как пустые строки, игнорируются. Символом комментария является '#' (0x23); на каждой строке игнорируются все символы после первого символа комментария. Файл должен быть закодирован в UTF-8.
Этот метод возвратит экземпляр первой реализации class, который это в состоянии загрузить и инстанцировать успешно от списка имен class, собранных у конфигурационных файлов. Этот метод использует контекст вызывающего потока classloader, чтобы найти конфигурационные файлы и загрузить реализацию class.
Если никакой class не может быть найден таким образом, этот метод будет использовать специфичный для реализации способ определить местоположение реализации. Если ни один не находится, NamingException бросается.
createExtendedResponse
в интерфейсе ExtendedRequest
id
- Объектный идентификатор расширенного ответа. Его значение должно быть "1.3.6.1.4.1.1466.20037" или нуль. Оба значения эквивалентны.berValue
- Возможно нулевой BER ASN.1 закодированное значение расширенного ответа. Это - необработанные байты BER включая тег и длину значения ответа. Это не включает OID ответа. Его значение игнорируется, потому что ответ TLS Запуска, как ожидают, не будет содержать значения ответа.offset
- Стартовая позиция в berValue байтов, чтобы использовать. Его значение игнорируется, потому что ответ TLS Запуска, как ожидают, не будет содержать значения ответа.length
- Число байтов в berValue, чтобы использовать. Его значение игнорируется, потому что ответ TLS Запуска, как ожидают, не будет содержать значения ответа.NamingException
- Если с исключением именования встретились, создавая StartTLS расширенный объект ответа.ExtendedResponse
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92