Package org.forgerock.opendj.ldap.requests

Interface CancelExtendedRequest

All Superinterfaces:

ExtendedRequest<ExtendedResult>, Request

public interface CancelExtendedRequest
extends ExtendedRequest<ExtendedResult>

The cancel extended request as defined in RFC 3909. This operation is similar to the abandon operation, except that it has a response and also requires the abandoned operation to return a response indicating it was canceled. This operation should be used instead of the abandon operation when the client needs an indication of the outcome. This operation may be used to cancel both interrogation and update operations.

See Also:

• RFC 3909 - Lightweight Directory Access Protocol (LDAP) Cancel Operation

Field Summary

Fields

Modifier and Type	Field	Description
static final ExtendedRequestDecoder<CancelExtendedRequest,ExtendedResult>	DECODER	A decoder which can be used to decode cancel extended operation requests.
static final String	OID	The OID for the cancel extended operation request.

Method Summary

Modifier and Type	Method	Description
CancelExtendedRequest	addControl(Control control)	Adds the provided control to this request.
<C extends Control> C	getControl(ControlDecoder<C> decoder, DecodeOptions options)	Decodes and returns the first control in this request having an OID corresponding to the provided control decoder.
List<Control>	getControls()	Returns a List containing the controls included with this request.
String	getOID()	Returns the numeric OID associated with this extended request.
int	getRequestID()	Returns the request ID of the request to be abandoned.
ExtendedResultDecoder<ExtendedResult>	getResultDecoder()	Returns a decoder which can be used to decoded responses to this extended request.
ByteString	getValue()	Returns the value, if any, associated with this extended request.
boolean	hasValue()	Returns true if this extended request has a value.
CancelExtendedRequest	setRequestID(int id)	Sets the request ID of the request to be abandoned.

Methods inherited from interface org.forgerock.opendj.ldap.requests.Request

containsControl

Field Details

DECODER

static final ExtendedRequestDecoder<CancelExtendedRequest,ExtendedResult> DECODER

A decoder which can be used to decode cancel extended operation requests.

OID

static final String OID

The OID for the cancel extended operation request.

See Also:

• Constant Field Values

Method Details

addControl

CancelExtendedRequest addControl(Control control)

Description copied from interface: Request

Adds the provided control to this request.

Specified by:

addControl in interface ExtendedRequest<ExtendedResult>

Specified by:

addControl in interface Request

Parameters:

control - The control to be added to this request.

Returns:

This request.

getControl

<C extends Control> C getControl(ControlDecoder<C> decoder,
 DecodeOptions options)
                          throws DecodeException

Description copied from interface: Request

Decodes and returns the first control in this request having an OID corresponding to the provided control decoder.

Specified by:

getControl in interface ExtendedRequest<ExtendedResult>

Specified by:

getControl in interface Request

Type Parameters:

C - The type of control to be decoded and returned.

Parameters:

decoder - The control decoder.

options - The set of decode options which should be used when decoding the control.

Returns:

The decoded control, or null if the control is not included with this request.

Throws:

DecodeException - If the control could not be decoded because it was malformed in some way (e.g. the control value was missing, or its content could not be decoded).

getControls

List<Control> getControls()

Description copied from interface: Request

Returns a List containing the controls included with this request. The returned List may be modified if permitted by this request.

Specified by:

getControls in interface ExtendedRequest<ExtendedResult>

Specified by:

getControls in interface Request

Returns:

A List containing the controls.

getOID

String getOID()

Description copied from interface: ExtendedRequest

Returns the numeric OID associated with this extended request.

Specified by:

getOID in interface ExtendedRequest<ExtendedResult>

Returns:

The numeric OID associated with this extended request.

getRequestID

int getRequestID()

Returns the request ID of the request to be abandoned.

Returns:

The request ID of the request to be abandoned.

getResultDecoder

ExtendedResultDecoder<ExtendedResult> getResultDecoder()

Description copied from interface: ExtendedRequest

Returns a decoder which can be used to decoded responses to this extended request.

Specified by:

getResultDecoder in interface ExtendedRequest<ExtendedResult>

Returns:

A decoder which can be used to decoded responses to this extended request.

getValue

ByteString getValue()

Description copied from interface: ExtendedRequest

Returns the value, if any, associated with this extended request. Its format is defined by the specification of this extended request.

Specified by:

getValue in interface ExtendedRequest<ExtendedResult>

Returns:

The value associated with this extended request, or null if there is no value.

hasValue

boolean hasValue()

Description copied from interface: ExtendedRequest

Returns true if this extended request has a value. In some circumstances it may be useful to determine if a extended request has a value, without actually calculating the value and incurring any performance costs.

Specified by:

hasValue in interface ExtendedRequest<ExtendedResult>

Returns:

true if this extended request has a value, or false if there is no value.

setRequestID

CancelExtendedRequest setRequestID(int id)

Sets the request ID of the request to be abandoned.

Parameters:

id - The request ID of the request to be abandoned.

Returns:

This abandon request.

Throws:

UnsupportedOperationException - If this abandon request does not permit the request ID to be set.