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 }
 

이 응답은, 임의의 객체 확장자(extension)와 임의의 ASN. 1 BER 로 encode 된 값으로 구성됩니다.

이 클래스의 메소드는, 확장 조작의 응답에 관한 저레벨 정보를 취득하는 어플리케이션에 의해 사용 가능합니다. 다만, 일반적으로 이 어플리케이션은, 이 인터페이스를 구현하고 있는 클래스 고유의 메소드를 사용합니다. 이러한 클래스는 응답 시에, BER 버퍼를 복호화 하고 있지 않으면 안되어, 형태 보증으로 사용자가 사용하기 쉬운 방법으로 사용자가 응답 데이터에 액세스 할 수 있는 메소드를 제공할 필요가 있습니다.

「시간 취득」의 확장 조작을 지원한 LDAP 서버를 예를 듭니다. 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 로 encode 된 값을 가져옵니다.
String	getID () 응답의 객체 확장자(extension)를 가져옵니다.

메소드의 상세

getID

String  getID()

응답의 객체 확장자(extension)를 가져옵니다. LDAP 프로토콜에서는, 응답 객체 식별자를 임의로 지정합니다. 서버가 이 식별자를 보내지 않는다고 응답에는 ID 가 포함되지 않습니다. 즉, null 가 됩니다.

반환값:

LDAP ExtendedResponse.responseName 컴퍼넌트를 나타내는, 객체의 식별자의 캐릭터 라인. null 의 경우도 있다

getEncodedValue

byte[] getEncodedValue()

LDAP 확장 조작의 응답의 ASN. 1 BER 로 encode 된 값을 가져옵니다. LDAP 서버로부터 반환된 응답에 이 값이 존재하지 않는 경우, null 를 돌려줍니다. 이 결과는, 응답치의 태그 및 길이를 포함한 그대로 (raw)의 BER 바이트로 표시됩니다. 다만, 응답 OID 는 포함하지 않는다.

반환값:

LDAP ExtendedResponse.response 컴퍼넌트의 ASN. 1 BER 로 encode 된 내용을 나타내는 null 의 가능성이 있다 바이트 배열