@NotMutable @ThreadSafety(level=COMPLETELY_THREADSAFE) public final class VirtualListViewResponseControl extends Control implements DecodeableControl
VirtualListViewRequestControl
.
resultCode
-- A result code that indicates the result of the
virtual list view processing. It may be the same as or different from
the result code contained in the search result done message.targetPosition
-- The offset of the target entry specified by
the client in the result set.contentCount
-- The estimated total number of entries in the
entire result set.contextID
-- An optional cookie that the client should include
in the next request as part of the virtual list view sequence.Modifier and Type | Field and Description |
---|---|
static java.lang.String |
VIRTUAL_LIST_VIEW_RESPONSE_OID
The OID (2.16.840.1.113730.3.4.10) for the virtual list view response
control.
|
Constructor and Description |
---|
VirtualListViewResponseControl(int targetPosition,
int contentCount,
ResultCode resultCode,
ASN1OctetString contextID)
Creates a new virtual list view response control with the provided
information.
|
VirtualListViewResponseControl(java.lang.String oid,
boolean isCritical,
ASN1OctetString value)
Creates a new virtual list view response control from the information
contained in the provided control.
|
Modifier and Type | Method and Description |
---|---|
VirtualListViewResponseControl |
decodeControl(java.lang.String oid,
boolean isCritical,
ASN1OctetString value)
Creates a new instance of this decodeable control from the provided
information.
|
static VirtualListViewResponseControl |
get(SearchResult result)
Extracts a virtual list view response control from the provided result.
|
int |
getContentCount()
Retrieves the estimated total number of entries in the result set.
|
ASN1OctetString |
getContextID()
Retrieves the context ID for this virtual list view response control, if
available.
|
java.lang.String |
getControlName()
Retrieves the user-friendly name for this control, if available.
|
ResultCode |
getResultCode()
Retrieves the result code for this virtual list view response control.
|
int |
getTargetPosition()
Retrieves the offset of the target entry for this virtual list view
response control.
|
void |
toString(java.lang.StringBuilder buffer)
Appends a string representation of this LDAP control to the provided
buffer.
|
decode, decode, decodeControls, deregisterDecodeableControl, encode, encodeControls, equals, getOID, getValue, hashCode, hasValue, isCritical, readFrom, registerDecodeableControl, toString, writeTo
public static final java.lang.String VIRTUAL_LIST_VIEW_RESPONSE_OID
public VirtualListViewResponseControl(int targetPosition, int contentCount, ResultCode resultCode, ASN1OctetString contextID)
targetPosition
- The offset of the target entry for this VLV
response control.contentCount
- The estimated total number of entries in the
result set.resultCode
- The result code for this VLV response control.contextID
- The context ID for this VLV response control. It
may be null
if no context ID is available.public VirtualListViewResponseControl(java.lang.String oid, boolean isCritical, ASN1OctetString value) throws LDAPException
oid
- The OID for the control.isCritical
- Indicates whether the control should be marked
critical.value
- The encoded value for the control. This may be
null
if no value was provided.LDAPException
- If a problem occurs while attempting to decode the
provided control as a virtual list view response
control.public VirtualListViewResponseControl decodeControl(java.lang.String oid, boolean isCritical, ASN1OctetString value) throws LDAPException
decodeControl
in interface DecodeableControl
oid
- The OID for the control.isCritical
- Indicates whether the control should be marked
critical.value
- The encoded value for the control. This may be
null
if no value was provided.LDAPException
- If the provided information cannot be decoded as a
valid instance of this decodeable control.public static VirtualListViewResponseControl get(SearchResult result) throws LDAPException
result
- The result from which to retrieve the virtual list view
response control.null
if the result did not contain a virtual
list view response control.LDAPException
- If a problem is encountered while attempting to
decode the virtual list view response control
contained in the provided result.public int getTargetPosition()
public int getContentCount()
public ResultCode getResultCode()
public ASN1OctetString getContextID()
null
if none was provided.public java.lang.String getControlName()
getControlName
in class Control