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 버퍼를 복호화(decode) 하고 있지 않으면 안되어, 형태 프로텍션으로 유저가 사용하기 쉬운 방법으로 유저가 응답 데이터에 액세스 할 수 있는 메소드를 제공할 필요가 있습니다.

「시간 취득」의 확장 조작을 서포트한 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

public String  getID()

응답의 오브젝트 확장자(extension)를 검출합니다. LDAP 프로토콜에서는 응답 오브젝트 식별자를 임의로 지정합니다. 서버가 이 식별자를 보내지 않는다고 응답에는 null 등의 ID 가 포함되지 않습니다.

반환값:

LDAP 의 ExtendedResponse.responseName 컴퍼넌트를 나타내는 null 이외의 오브젝트 식별자의 캐릭터 라인

getEncodedValue

public byte[] getEncodedValue()

LDAP 확장 조작의 응답으로 ASN. 1 BER 로 encode 된 값을 검출합니다. LDAP 서버에 의해 돌려주어진 값이 비었을 경우, null 가 돌려주어집니다. 이 결과는 응답치의 태그 및 길이를 포함한 그대로 (raw)의 BER 바이트로 표시됩니다. 다만, 응답의 OID 에 대해서는 표시되지 않습니다.

반환값:

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