org.ldaptive.control

Class PagedResultsControl

java.lang.Object

org.ldaptive.control.AbstractControl

org.ldaptive.control.PagedResultsControl

All Implemented Interfaces:

Control, RequestControl, ResponseControl

public class PagedResultsControl
extends AbstractControl
implements RequestControl, ResponseControl

Request/response control for PagedResults. See RFC 2696. Control is defined as:

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

Author:

Middleware Services

Field Summary

Fields

Modifier and Type	Field and Description
static String	OID OID of this control.

Fields inherited from class org.ldaptive.control.AbstractControl

logger

Constructor Summary

Constructors

Constructor and Description
PagedResultsControl() Default constructor.
PagedResultsControl(boolean critical) Creates a new paged results control.
PagedResultsControl(int size) Creates a new paged results control.
PagedResultsControl(int size, boolean critical) Creates a new paged results control.
PagedResultsControl(int size, byte[] value, boolean critical) Creates a new paged results control.

Method Summary

Modifier and Type	Method and Description
void	decode(byte[] berValue) Initializes this response control with the supplied BER encoded data.
byte[]	encode() Provides the BER encoding of this control.
byte[]	getCookie() Returns the paged results cookie.
int	getSize() Returns the paged results size.
int	hashCode() Returns the hash code for this object.
void	setCookie(byte[] value) Sets the paged results cookie.
void	setSize(int size) Sets the paged results size.
String	toString()

Methods inherited from class org.ldaptive.control.AbstractControl

equals, getCriticality, getOID

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.ldaptive.control.Control

getCriticality, getOID

Field Detail

OID

public static final String OID

OID of this control.

See Also:

Constant Field Values

Constructor Detail

PagedResultsControl

public PagedResultsControl()

Default constructor.

PagedResultsControl

public PagedResultsControl(boolean critical)

Creates a new paged results control.

Parameters:

critical - whether this control is critical

PagedResultsControl

public PagedResultsControl(int size)

Creates a new paged results control.

Parameters:

size - paged results size

PagedResultsControl

public PagedResultsControl(int size,
                           boolean critical)

Creates a new paged results control.

Parameters:

size - paged results size

critical - whether this control is critical

PagedResultsControl

public PagedResultsControl(int size,
                           byte[] value,
                           boolean critical)

Creates a new paged results control.

Parameters:

size - paged results size

value - paged results cookie

critical - whether this control is critical

Method Detail

getSize

public int getSize()

Returns the paged results size. For requests this is the requested page size. For responses this is the result size estimate from the server.

Returns:

paged results size

setSize

public void setSize(int size)

Sets the paged results size. For requests this is the requested page size. For responses this is the result size estimate from the server.

Parameters:

size - paged results size

getCookie

public byte[] getCookie()

Returns the paged results cookie.

Returns:

paged results cookie

setCookie

public void setCookie(byte[] value)

Sets the paged results cookie.

Parameters:

value - paged results cookie

hashCode

public int hashCode()

Description copied from class: AbstractControl

Returns the hash code for this object.

Specified by:

hashCode in class AbstractControl

Returns:

hash code

toString

public String toString()

Overrides:

toString in class Object

encode

public byte[] encode()

Description copied from interface: RequestControl

Provides the BER encoding of this control.

Specified by:

encode in interface RequestControl

Returns:

BER encoded request control

decode

public void decode(byte[] berValue)

Description copied from interface: ResponseControl

Initializes this response control with the supplied BER encoded data.

Specified by:

decode in interface ResponseControl

Parameters:

berValue - BER encoded response control