public class StartTlsRequest extends Object implements ExtendedRequest
StartTlsResponse分之StartTlsRequest用来建立在与其上extendedOperation()被调用JNDI上下文相关联的现有的LDAP连接的TLS连接。 通常,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
, Serialized Form
Modifier and Type | Field and Description |
---|---|
static String |
OID
StartTLS扩展请求的分配对象标识符为1.3.6.1.4.1.1466.20037。
|
Constructor and Description |
---|
StartTlsRequest()
构建一个StartTLS扩展请求。
|
Modifier and Type | Method and Description |
---|---|
ExtendedResponse |
createExtendedResponse(String id, byte[] berValue, int offset, int length)
创建对应于LDAP StartTLS扩展请求的扩展响应对象。
|
byte[] |
getEncodedValue()
检索StartTLS请求的ASN.1 BER编码值。
|
String |
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的具体子类,并且必须具有公共零参数构造函数。
该方法通过查找具有以下名称的配置文件来定位实现类:
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字节。
它不包括响应OID。
它的值将被忽略,因为启动TLS响应不会包含任何响应值。
offset
- 在berValue中使用的字节的起始位置。
它的值将被忽略,因为启动TLS响应不会包含任何响应值。
length
- 要使用的berValue中的字节数。
它的值将被忽略,因为启动TLS响应不会包含任何响应值。
NamingException
- 如果在创建StartTLS扩展响应对象时遇到命名异常。
ExtendedResponse
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.