Java javax.naming.ldap 接口 ExtendedResponse（JDK5）

所有类

javax.naming.ldap
接口 ExtendedResponse

所有超级接口：

Serializable

所有已知子接口：

UnsolicitedNotification

所有已知实现类：

StartTlsResponse

public interface ExtendedResponse
   
   
   
   
   
extends Serializable
   
   
   
   
   

此接口表示在 RFC 2251 中定义的 LDAP 扩展操作响应。

     ExtendedResponse ::= [APPLICATION 24] SEQUENCE {
          COMPONENTS OF LDAPResult,
          responseName     [10] LDAPOID OPTIONAL,
          response         [11] OCTET STRING OPTIONAL }
 

应用程序可以使用此类中的方法获取关于扩展操作响应的低级信息。但是，应用程序通常将使用特定于实现此接口的类的方法。这种类应该已经解码了响应中的 BER 缓冲区，并应该提供一些方法允许用户以类型安全的、友好的方式访问响应中数据。

例如，假定 LDAP 服务器支持“获取时间”扩展操作。它将提供 GetTimeRequest 和 GetTimeResponse 类。GetTimeResponse 类可能如下所示：

 public class GetTimeResponse implements ExtendedResponse {
     public java.util.Date getDate() {...};
     public long getTime() {...};
     ....
 }

 GetTimeResponse resp =
        (GetTimeResponse) ectx.extendedOperation(new GetTimeRequest());
 java.util.Date now = resp.getDate();

从以下版本开始：

1.3

另请参见：

ExtendedRequest

getID

String getID()

检索响应的对象标识符。LDAP 协议指定响应对象标识符是可选的。如果服务器不发送它，则响应不包含任何 ID（即 null）。

返回：

表示 LDAP ExtendedResponse.responseName 组件的对象标识符字符串（可能为 null）。

getEncodedValue

byte[] getEncodedValue()

检索 LDAP 扩展操作响应的 ASN.1 BER 编码值。如果该值不在 LDAP 服务器发送的响应中，则返回 null。结果为原始 BER 字节，包括响应值的标记和长度。它不包括响应 OID。

返回：

表示 LDAP ExtendedResponse.response 组件的 ASN.1 BER 编码内容的字节数组（可能为 null）。