|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.unboundid.ldap.sdk.Control
com.unboundid.ldap.sdk.unboundidds.controls.InteractiveTransactionSpecificationRequestControl
@NotMutable @ThreadSafety(level=COMPLETELY_THREADSAFE) public final class InteractiveTransactionSpecificationRequestControl
NOTE: This class is part of the Commercial Edition of the UnboundID LDAP SDK for Java. It is not available for use in applications that include only the Standard Edition of the LDAP SDK, and is not supported for use in conjunction with non-UnboundID products.This class provides an implementation of the interactive transaction specification request control, which may be used to indicate that the associated operation is part of an interactive transaction. It may be used in conjunction with add, compare, delete, modify, modify DN, and search requests, as well as some types of extended requests. The transaction should be created with the start interactive transaction extended request, and the end interactive transaction extended request may be used to commit or abort the associated transaction.
txnID
-- The transaction ID for the transaction, which was
obtained from a previous
StartInteractiveTransactionExtendedResult
.abortOnFailure
-- Indicates whether the transaction should
be aborted if the request associated with this control does not
complete successfully.writeLock
-- Indicates whether the target entry may be
altered by this or a subsequent operation which is part of the
transaction. It should generally be false
only for read
operations in which it is known that the target entry will not be
altered by a subsequent operation.StartInteractiveTransactionExtendedRequest
class for an example of
processing an interactive transaction.
Field Summary | |
---|---|
static java.lang.String |
INTERACTIVE_TRANSACTION_SPECIFICATION_REQUEST_OID
The OID (1.3.6.1.4.1.30221.2.5.4) for the interactive transaction specification request control. |
Constructor Summary | |
---|---|
InteractiveTransactionSpecificationRequestControl(ASN1OctetString transactionID)
Creates a new interactive transaction specification request control with the provided transaction ID. |
|
InteractiveTransactionSpecificationRequestControl(ASN1OctetString transactionID,
boolean abortOnFailure,
boolean writeLock)
Creates a new interactive transaction specification request control with the provided information. |
|
InteractiveTransactionSpecificationRequestControl(Control control)
Creates a new interactive transaction specification request control which is decoded from the provided generic control. |
Method Summary | |
---|---|
boolean |
abortOnFailure()
Indicates whether the transaction should be aborted if the associated operation does not complete successfully. |
java.lang.String |
getControlName()
Retrieves the user-friendly name for this control, if available. |
ASN1OctetString |
getTransactionID()
Retrieves the transaction ID for the associated transaction. |
void |
toString(java.lang.StringBuilder buffer)
Appends a string representation of this LDAP control to the provided buffer. |
boolean |
writeLock()
Indicates whether the server should attempt to obtain a write lock on entries targeted by the associated operation. |
Methods inherited from class com.unboundid.ldap.sdk.Control |
---|
decode, decode, decodeControls, deregisterDecodeableControl, encode, encodeControls, equals, getOID, getValue, hashCode, hasValue, isCritical, readFrom, registerDecodeableControl, toString, writeTo |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public static final java.lang.String INTERACTIVE_TRANSACTION_SPECIFICATION_REQUEST_OID
Constructor Detail |
---|
public InteractiveTransactionSpecificationRequestControl(ASN1OctetString transactionID)
transactionID
- The transaction ID for the associated transaction,
as obtained from the start interactive transaction
extended operation. It must not be null
.public InteractiveTransactionSpecificationRequestControl(ASN1OctetString transactionID, boolean abortOnFailure, boolean writeLock)
transactionID
- The transaction ID for the associated transaction,
as obtained from the start interactive transaction
extended operation. It must not be null
.abortOnFailure
- Indicates whether the transaction should be aborted
if the associated operation does not complete
successfully.writeLock
- Indicates whether the server should attempt to
obtain a write lock on the target entry. This
should only be false
if the associated
operation is a search or compare and it is known
that the target entry will not be updated later in
the transaction.public InteractiveTransactionSpecificationRequestControl(Control control) throws LDAPException
control
- The generic control to be decoded as an interactive
transaction specification request control.
LDAPException
- If the provided control cannot be decoded as an
interactive transaction specification request
control.Method Detail |
---|
public ASN1OctetString getTransactionID()
public boolean abortOnFailure()
true
if the transaction should be aborted if the
associated operation does not complete successfully, or
false
if the server should attempt to keep the transaction
active if the associated operation does not complete successfully.public boolean writeLock()
true
if the server should attempt to obtain a write lock
on entries targeted by the associated operation, or false
if a read lock is acceptable as the entries are not expected to
be altered later in the transaction.public java.lang.String getControlName()
getControlName
in class Control
public void toString(java.lang.StringBuilder buffer)
toString
in class Control
buffer
- The buffer to which to append the string representation of
this buffer.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |