javax.naming.ldap
인터페이스 Control

모든 슈퍼 인터페이스:

Serializable

기존의 구현 클래스의 일람:

BasicControl , ManageReferralControl , PagedResultsControl , PagedResultsResponseControl , SortControl , SortResponseControl

public interface Control
extends Serializable 

이 인터페이스는,「RFC 2251」으로 정의되고 있도록(듯이) LDAPv3 컨트롤을 표시합니다.

LDAPv3 프로토콜은, 컨트롤을 사용해 추가 데이터의 송수신을 실시해 사전 정의된 조작의 동작에 영향을 줍니다. 컨트롤은, LDAP 조작과 함께 서버에 송신하는 것이 가능합니다. 이러한 컨트롤을요구 컨트롤이라고 합니다. 예를 들어, 소트 컨트롤의 경우, 지정한 순서로 결과를 돌려주도록(듯이) 요구하는 LDAP 의 검색 조작 때에 송신할 수 있습니다. 요청 및 비요청 컨트롤의 경우도, 서버의 응답을 돌려줄 수가 있습니다. 이러한 컨트롤을응답 컨트롤이라고 합니다. 예를 들어 LDAP 서버에서는, 변경 통지를 돌려주는 특별한 컨트롤을 정의할 수 있습니다.

이 인터페이스는, 요구 컨트롤 및 응답 컨트롤을 표시하는데 사용됩니다.

도입된 버젼:

1.3

관련 항목:

ControlFactory

필드의 개요

static boolean	CRITICAL 위기 컨트롤을 나타냅니다.
static boolean	NONCRITICAL 비위기 컨트롤을 나타냅니다.

메소드의 개요

byte[]	getEncodedValue () LDAP 컨트롤의 ASN. 1 BER 로 encode 된 값을 검출합니다.
String	getID () LDAP 컨트롤로 지정된 객체 식별자를 검출합니다.
boolean	isCritical () LDAP 컨트롤의 위기 컨트롤을 판별합니다.

필드의 상세

CRITICAL

static final boolean CRITICAL

위기 컨트롤을 나타냅니다. 이 정수의 값은 true 입니다.

관련 항목:

정수 필드치

NONCRITICAL

static final boolean NONCRITICAL

비위기 컨트롤을 나타냅니다. 이 정수의 값은 false 입니다.

관련 항목:

정수 필드치

메소드의 상세

getID

String  getID()

LDAP 컨트롤로 지정된 객체 식별자를 검출합니다.

반환값:

null 이외의 객체 식별자의 캐릭터 라인

isCritical

boolean isCritical()

LDAP 컨트롤의 위기 컨트롤을 판별합니다. 위기 컨트롤이면, 서버는 무시할 수 없습니다. 즉, 서버가 지원하고 있지 않는 위기 컨트롤을 받으면(자), 컨트롤이 조작에 있어 중요한지 어떤지에 관련되지 않고, 조작은 실행되지 않고 ,OperationNotSupportedException 가 throw 됩니다.

반환값:

이 컨트롤이 위기의 경우는 true, 그렇지 않은 경우는 false

getEncodedValue

byte[] getEncodedValue()

LDAP 컨트롤의 ASN. 1 BER 로 encode 된 값을 검출합니다. 이 결과는, 컨트롤치의 태그 및 길이를 포함한 그대로 (raw)의 BER 바이트로 표시됩니다. 다만, 컨트롤의 OID 또는 위기의 정도에 대해서는 표시되지 않습니다. 값이 빈 상태(empty)의 경우, null 가 돌려주어집니다.

반환값:

LDAP 컨트롤의 ASN. 1 BER 로 encode 된 값을 나타낸다 null 의 가능성이 있는 바이트 배열