JavaTM 2 Platform
Standard Ed. 6

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 }
 
它包含可選的物件標識符和可選的 ASN.1 BER 編碼值。

應用程序可以使用此類別中的方法獲取關於擴展操作回應的低層級資訊。但是,應用程序通常將使用特定於實作此介面的類別的方法。這種類別應該已經解碼了回應中的 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

方法摘要
 byte[] getEncodedValue()
          檢索 LDAP 擴展操作回應的 ASN.1 BER 編碼值。
 String getID()
          檢索回應的物件標識符。
 

方法詳細資訊

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

JavaTM 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only