Class PagedResultsResponseControl

public final class PagedResultsResponseControl
extends BasicControl

검색 결과 배치(batch)의 끝을 나타내요. 결과 집합의 총 항목 수에 대한 추정치와 불투명한 쿠키를 포함해요. 다음 검색 연산에서 다음 결과 배치를 얻으려면 쿠키를 제공해야 해요. PagedResultsControl의 코드 샘플은 이 클래스의 사용법을 보여줘요. 이 클래스는 RFC 2696에 정의된 페이징 결과(paged-results)에 대한 LDAPv3 Response Control을 구현해요. 컨트롤 값은 다음과 같은 ASN.1 정의를 가져요.

realSearchControlValue ::= SEQUENCE {
    size INTEGER (0..maxInt),
    -- requested page size from client
    -- result set size estimate from server
    cookie OCTET STRING }

OID

public static final String OID

페이징 결과 응답 컨트롤의 할당된 객체 식별자는 1.2.840.113556.1.4.319예요.

See Also: 상수 필드 값(Constant Field Values)

PagedResultsResponseControl

public PagedResultsResponseControl(String id,
 boolean criticality,
 byte[] value)
                            throws IOException

페이징 결과 응답 컨트롤을 생성해요.

Parameters: id - 컨트롤의 객체 식별자 문자열
Throws: IOException - 컨트롤 값을 디코딩하는 동안 오류가 발생했을 때

getResultSize

public int getResultSize()

검색 결과의 항목 수(추정치)를 가져와요.

Returns: 검색 결과의 항목 수, 또는 알 수 없으면 0

getCookie

public byte[] getCookie()

서버가 생성한 쿠키를 가져와요. 서버가 반환할 항목이 더 이상 없으면 null이 반환돼요.

Returns: null일 수 있는 서버 생성 쿠키. 복제(clone)되지 않아요 — 쿠키를 변경하면 컨트롤 상태가 갱신되므로 권장되지 않아요