The code sample in PagedResultsControl
shows how this class may
be used.
This class implements the LDAPv3 Response Control for paged-results as defined in RFC 2696. The control's value has the following ASN.1 definition:
realSearchControlValue ::= SEQUENCE { size INTEGER (0..maxInt), -- requested page size from client -- result set size estimate from server cookie OCTET STRING }
PagedResultsControl
Modifier and Type | Field and Description |
---|---|
private byte[] | cookie
A server-generated cookie. |
public static final String | OID
The paged-results response control's assigned object identifier is 1.2.840.113556.1.4.319. |
private int | resultSize
An estimate of the number of entries in the search result. |
private static final long |
Access | Constructor and Description |
---|---|
public | PagedResultsResponseControl(String
The control's object identifier string. id, boolean The control's criticality. criticality, byte[] The control's ASN.1 BER encoded value.
It is not cloned - any changes to value
will affect the contents of the control. value)Constructs a paged-results response control. |
Modifier and Type | Method and Description |
---|---|
public byte[] | Returns: A possibly null server-generated cookie. It is not cloned - any changes to the cookie will update the control's state and thus are not recommended.Retrieves the server-generated cookie. |
public int | Returns: The number of entries in the search result, or zero if unknown.Retrieves (an estimate of) the number of entries in the search result. |
cookie | back to summary |
---|---|
private byte[] cookie A server-generated cookie. |
OID | back to summary |
---|---|
public static final String OID The paged-results response control's assigned object identifier is 1.2.840.113556.1.4.319. |
resultSize | back to summary |
---|---|
private int resultSize An estimate of the number of entries in the search result. |
serialVersionUID | back to summary |
---|---|
private static final long serialVersionUID |
PagedResultsResponseControl | back to summary |
---|---|
public PagedResultsResponseControl(String id, boolean criticality, byte[] value) throws IOException Constructs a paged-results response control.
|
getCookie | back to summary |
---|---|
public byte[] getCookie() Retrieves the server-generated cookie. Null is returned when there are no more entries for the server to return.
|
getResultSize | back to summary |
---|---|
public int getResultSize() Retrieves (an estimate of) the number of entries in the search result.
|