Class Overview
Indicates the end of a batch of search results.
Contains an estimate of the total number of entries in the result set
and an opaque cookie. The cookie must be supplied to the next search
operation in order to get the next batch of results.
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
}
Summary
Constants |
String |
OID |
The paged-results response control's assigned object identifier
is 1.2.840.113556.1.4.319. |
Public Methods |
byte[]
|
getCookie()
Retrieves the server-generated cookie.
|
int
|
getResultSize()
Retrieves (an estimate of) the number of entries in the search result.
|
[Expand]
Inherited Methods |
From class
javax.naming.ldap.BasicControl
byte[]
|
getEncodedValue()
Retrieves the control's ASN.1 BER encoded value.
|
String
|
getID()
Retrieves the control's object identifier string.
|
boolean
|
isCritical()
Determines the control's criticality.
|
|
From class
java.lang.Object
Object
|
clone()
Creates and returns a copy of this object.
|
boolean
|
equals(Object obj)
Indicates whether some other object is "equal to" this one.
|
void
|
finalize()
Called by the garbage collector on an object when garbage collection
determines that there are no more references to the object.
|
final
Class<?>
|
getClass()
Returns the runtime class of this Object .
|
int
|
hashCode()
Returns a hash code value for the object.
|
final
void
|
notify()
Wakes up a single thread that is waiting on this object's
monitor.
|
final
void
|
notifyAll()
Wakes up all threads that are waiting on this object's monitor.
|
String
|
toString()
Returns a string representation of the object.
|
final
void
|
wait()
Causes the current thread to wait until another thread invokes the
notify() method or the
notifyAll() method for this object.
|
final
void
|
wait(long timeout, int nanos)
Causes the current thread to wait until another thread invokes the
notify() method or the
notifyAll() method for this object, or
some other thread interrupts the current thread, or a certain
amount of real time has elapsed.
|
final
void
|
wait(long timeout)
Causes the current thread to wait until either another thread invokes the
notify() method or the
notifyAll() method for this object, or a
specified amount of time has elapsed.
|
|
From interface
javax.naming.ldap.Control
abstract
byte[]
|
getEncodedValue()
Retrieves the ASN.1 BER encoded value of the LDAP control.
|
abstract
String
|
getID()
Retrieves the object identifier assigned for the LDAP control.
|
abstract
boolean
|
isCritical()
Determines the criticality of the LDAP control.
|
|
Constants
public
static
final
String
OID
The paged-results response control's assigned object identifier
is 1.2.840.113556.1.4.319.
Constant Value:
"1.2.840.113556.1.4.319"
Public Constructors
public
PagedResultsResponseControl
(String id, boolean criticality, byte[] value)
Constructs a paged-results response control.
Parameters
id
| The control's object identifier string. |
criticality
| The control's criticality. |
value
| The control's ASN.1 BER encoded value.
It is not cloned - any changes to value
will affect the contents of the control. |
Throws
IOException
| If an error was encountered while decoding
the control's value.
|
Public Methods
public
byte[]
getCookie
()
Retrieves the server-generated cookie. Null is returned when there are
no more entries for the server to return.
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.
public
int
getResultSize
()
Retrieves (an estimate of) the number of entries in the search result.
Returns
- The number of entries in the search result, or zero if unknown.