接口 | 描述 |
---|---|
Control |
此接口表示为在所定义的控制LDAPv3的
RFC 2251 。
|
ExtendedRequest |
此接口表示为在限定的LDAPv3扩展操作请求
RFC 2251 。
|
ExtendedResponse |
此接口表示为在限定的LDAP扩展操作响应
RFC 2251 。
|
HasControls |
此接口用于使用NamingEnumerations返回的对象返回控件。
|
LdapContext |
此接口表示您可以使用LDAPv3样式控件执行操作并执行LDAPv3样式扩展操作的上下文。
|
UnsolicitedNotification |
此接口表示RFC 2251中定义的
未经请求的通知 。
|
UnsolicitedNotificationListener |
该接口用于处理
UnsolicitedNotificationEvent 。
|
类 | 描述 |
---|---|
BasicControl |
这个类提供了
Control接口的基本实现。
|
ControlFactory |
这个抽象类代表一个用于创建LDAPv3控件的工厂。
|
InitialLdapContext |
此类是执行LDAPv3风格的扩展操作和控件的起始上下文。
|
LdapName |
此类表示由指定的专有名称
RFC 2253 。
|
ManageReferralControl |
请求将引用和其他特殊LDAP对象作为普通LDAP对象进行操作。
|
PagedResultsControl |
请求LDAP服务器以指定大小的批量返回搜索操作的结果。
|
PagedResultsResponseControl |
表示一批搜索结果的结束。
|
Rdn |
此类表示相对可分辨名称,或RDN,它是由RFC 2253指定的专有名称的组成
部分 。
|
SortControl |
请求在返回之前由LDAP服务器对搜索操作的结果进行排序。
|
SortKey |
排序键及其相关的排序参数。
|
SortResponseControl |
指示所请求的搜索结果是否成功。
|
StartTlsRequest |
该类实现了88242676256073中定义的StartTLS的LDAPv3扩展请求
。StartTLS的对象标识符为1.3.6.1.4.1.1466.20037,未定义扩展请求值。
|
StartTlsResponse |
此类实现了88242676271468中定义的StartTLS的LDAPv3扩展响应
。StartTLS的对象标识符为1.3.6.1.4.1.1466.20037,未定义扩展响应值。
|
UnsolicitedNotificationEvent |
此类表示响应LDAP服务器发送的未经请求的通知触发的事件。
|
异常 | 描述 |
---|---|
LdapReferralException |
此抽象类用于表示LDAP引用异常。
|
此包扩展了Java命名和目录接口TM (JNDI)的目录操作。 JNDI为以Java编程语言编写的应用程序提供命名和目录功能。 它被设计为独立于任何特定的命名或目录服务实现。 因此,可以以一种常见的方式访问各种服务 - 新的,新兴的和已经部署的服务。
此包适用于处理LDAPv3扩展操作和控件的应用程序和服务提供商,如RFC 2251所定义。 该包中的核心接口是LdapContext ,它定义了上下文中用于执行扩展操作和处理控件的方法。
这个包定义了接口ExtendedRequest表示的参数的扩展操作,并且接口ExtendedResponse来表示扩展操作的结果。 扩展响应始终与扩展请求配对,但不一定反之亦然。 也就是说,您可以有一个没有相应扩展响应的扩展请求。
应用程序通常不直接处理这些接口。 相反,它处理实现这些接口的类。 应用程序将这些类作为通过IETF标准化的扩展操作的一部分,或从目录供应商获取供应商特定扩展操作的一部分。 请求类应该具有以类型安全和用户友好的方式接受参数的构造函数,而响应类应该具有以类型安全和用户友好的方式获取响应的数据的访问方法。 在内部,请求/响应类处理BER值的编码和解码。
例如,假设LDAP服务器支持“获取时间”扩展操作。 它将提供类别,如GetTimeRequest和GetTimeResponse ,以便应用程序可以使用此功能。 应用程序将使用以下类:
GetTimeResponse resp = (GetTimeResponse) ectx.extendedOperation(new GetTimeRequest()); long time = resp.getTime();
GetTimeRequest和GetTimeResponse类可能定义如下:
public class GetTimeRequest implements ExtendedRequest { // User-friendly constructor public GetTimeRequest() { }; // Methods used by service providers public String getID() { return GETTIME_REQ_OID; } public byte[] getEncodedValue() { return null; // no value needed for get time request } public ExtendedResponse createExtendedResponse( String id, byte[] berValue, int offset, int length) throws NamingException { return new GetTimeResponse(id, berValue, offset, length); } } public class GetTimeResponse() implements ExtendedResponse { long time; // called by GetTimeRequest.createExtendedResponse() public GetTimeResponse(String id, byte[] berValue, int offset, int length) throws NamingException { // check validity of id long time = ... // decode berValue to get time } // Type-safe and User-friendly methods public java.util.Date getDate() { return new java.util.Date(time); } public long getTime() { return time; } // Low level methods public byte[] getEncodedValue() { return // berValue saved; } public String getID() { return GETTIME_RESP_OID; } }
应用程序通常不直接处理此接口。 而是处理实现此接口的类。 应用程序获取控制类,作为通过IETF标准化的控件的一部分,或从供应商特定控件的目录供应商获取控制类。 请求控制类应该具有以类型安全和用户友好的方式接受参数的构造函数,而响应控制类应该具有以类型安全和用户友好的方式获取响应的数据的访问方法。 在内部,请求/响应控制类处理BER值的编码和解码。
例如,假设LDAP服务器支持“签名结果”请求控制,当请求发送时,请求服务器对操作的结果进行数字签名。 它将提供一个类别SignedResultsControl ,以便应用程序可以使用此功能。 应用程序将使用此类如下:
SignedResultsControl类可能定义如下:Control[] reqCtls = new Control[] {new SignedResultsControl(Control.CRITICAL)}; ectx.setRequestControls(reqCtls); NamingEnumeration enum = ectx.search(...);
public class SignedResultsControl implements Control { // User-friendly constructor public SignedResultsControl(boolean criticality) { // assemble the components of the request control }; // Methods used by service providers public String getID() { return // control's object identifier } public byte[] getEncodedValue() { return // ASN.1 BER encoded control value } ... }
当服务提供商接收响应控制时,它使用ControlFactory类以产生实现Control接口特定的类。
LDAP服务器可以使用LDAP操作发回响应控件,还可以使用列举或搜索操作返回的枚举结果。 LdapContext提供了一种用于获取使用LDAP操作发送的响应控件的方法( getResponseControls() ),而HasControls接口用于检索与枚举结果相关联的响应控件。
例如,假设一个LDAP服务器发送一个“更改ID”控件以响应成功的修改。 它将提供一个类别ChangeIDControl ,以便应用程序可以使用此功能。 应用程序将执行更新,然后尝试获取更改ID。
供应商可能会提供以下ChangeIDControl和VendorXControlFactory类。 当提供者从LDAP服务器接收响应控制时, VendorXControlFactory将由服务提供商使用。// Perform update Context ctx = ectx.createSubsubcontext("cn=newobj"); // Get response controls Control[] respCtls = ectx.getResponseControls(); if (respCtls != null) { // Find the one we want for (int i = 0; i < respCtls; i++) { if(respCtls[i] instanceof ChangeIDControl) { ChangeIDControl cctl = (ChangeIDControl)respCtls[i]; System.out.println(cctl.getChangeID()); } } }
public class ChangeIDControl implements Control { long id; // Constructor used by ControlFactory public ChangeIDControl(String OID, byte[] berVal) throws NamingException { // check validity of OID id = // extract change ID from berVal }; // Type-safe and User-friendly method public long getChangeID() { return id; } // Low-level methods public String getID() { return CHANGEID_OID; } public byte[] getEncodedValue() { return // original berVal } ... } public class VendorXControlFactory extends ControlFactory { public VendorXControlFactory () { } public Control getControlInstance(Control orig) throws NamingException { if (isOneOfMyControls(orig.getID())) { ... // determine which of ours it is and call its constructor return (new ChangeIDControl(orig.getID(), orig.getEncodedValue())); } return null; // not one of ours } }
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.