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 ExtendedRequest.requestValue 컴퍼넌트의 ASN. 1 BER 로 encode 된 내용을 나타내는 null 가능성이 있는 바이트 배열