@NotMutable @ThreadSafety(level=COMPLETELY_THREADSAFE) public final class PostReadResponseControl extends Control implements DecodeableControl
PostReadRequestControl
and the operation was successful, then the
response for that operation should include the post-read response control
with a read-only copy of the entry as it appeared immediately after
processing the request. If the operation was not successful, then the
post-read response control will not be returned.Modifier and Type | Field and Description |
---|---|
static java.lang.String |
POST_READ_RESPONSE_OID
The OID (1.3.6.1.1.13.2) for the post-read response control.
|
Constructor and Description |
---|
PostReadResponseControl(ReadOnlyEntry entry)
Creates a new post-read response control including the provided entry.
|
PostReadResponseControl(java.lang.String oid,
boolean isCritical,
ASN1OctetString value)
Creates a new post-read response control with the provided information.
|
Modifier and Type | Method and Description |
---|---|
PostReadResponseControl |
decodeControl(java.lang.String oid,
boolean isCritical,
ASN1OctetString value)
Creates a new instance of this decodeable control from the provided
information.
|
static PostReadResponseControl |
get(LDAPResult result)
Extracts a post-read response control from the provided result.
|
java.lang.String |
getControlName()
Retrieves the user-friendly name for this control, if available.
|
ReadOnlyEntry |
getEntry()
Retrieves a read-only copy of the entry returned by this post-read 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 POST_READ_RESPONSE_OID
public PostReadResponseControl(ReadOnlyEntry entry)
entry
- The entry to include in this post-read response control. It
must not be null
.public PostReadResponseControl(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 the provided control cannot be decoded as a
post-read response control.public PostReadResponseControl 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 PostReadResponseControl get(LDAPResult result) throws LDAPException
result
- The result from which to retrieve the post-read response
control.null
if the result did not contain a post-read response
control.LDAPException
- If a problem is encountered while attempting to
decode the post-read response control contained in
the provided result.public ReadOnlyEntry getEntry()
public java.lang.String getControlName()
getControlName
in class Control