javax.naming.ldap

Класс StartTlsRequest

java.lang. Объект

javax.naming.ldap. StartTlsRequest

Все Реализованные Интерфейсы:

Сериализуемый, 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

См. Также:

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.

Методы java.lang унаследованный от класса. Объект

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()

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

Определенный:

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

Возвраты:

Нулевое значение.

createExtendedResponse

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

Создает расширенный объект ответа, который соответствует StartTLS LDAP расширенный запрос.

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

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

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

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

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

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

Если никакой класс не может быть найден таким образом, этот метод будет использовать специфичный для реализации способ определить местоположение реализации. Если ни один не находится, 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 Запуска, как ожидают, не будет содержать значения ответа.

Возвраты:

StartTLS расширенный объект ответа.

Броски:

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

См. Также:

ExtendedResponse