Package org.opends.server.core

Class ExtendedOperationBasis

java.lang.Object

org.opends.server.types.AbstractOperation

org.opends.server.core.ExtendedOperationBasis

All Implemented Interfaces:

Runnable, ExtendedOperation, Operation, PluginOperation, PostOperationExtendedOperation, PostOperationOperation, PostResponseExtendedOperation, PostResponseOperation, PreOperationExtendedOperation, PreOperationOperation, PreParseExtendedOperation, PreParseOperation

public class ExtendedOperationBasis
extends AbstractOperation
implements ExtendedOperation, PreParseExtendedOperation, PreOperationExtendedOperation, PostOperationExtendedOperation, PostResponseExtendedOperation

This class defines an extended operation, which can perform virtually any kind of task.

Field Summary

Fields inherited from class org.opends.server.types.AbstractOperation

cancelRequest, cancelResult, clientConnection, messageID, NO_RESPONSE_CONTROLS, operationID

Fields inherited from interface org.opends.server.types.Operation

LOCALBACKENDOPERATIONS

Constructor Summary

Constructors

Constructor	Description
ExtendedOperationBasis(ClientConnection clientConnection, long operationID, int messageID, List<Control> requestControls, String requestOID, ByteString requestValue)	Creates a new extended operation with the provided information.

Method Summary

Modifier and Type	Method	Description
void	addResponseControl(Control control)	Adds the provided control to the set of controls to include in the response to the client.
OperationType	getOperationType()	Retrieves the operation type for this operation.
DN	getProxiedAuthorizationDN()	Retrieves the proxied authorization DN for this operation if proxied authorization has been requested.
String	getRequestOID()	Retrieves the OID for the request associated with this extended operation.
ByteString	getRequestValue()	Retrieves the value for the request associated with this extended operation.
List<Control>	getResponseControls()	Retrieves the set of controls to include in the response to the client.
String	getResponseOID()	Retrieves the OID to include in the response to the client.
ByteString	getResponseValue()	Retrieves the value to include in the response to the client.
void	removeResponseControl(Control control)	Removes the provided control from the set of controls to include in the response to the client.
void	run()	Performs the work of actually processing this operation.
void	setProxiedAuthorizationDN(DN proxiedAuthorizationDN)	Set the proxied authorization DN for this operation if proxied authorization has been requested.
void	setRequestOID(String requestOID)	Specifies the OID for the request associated with this extended operation.
void	setRequestValue(ByteString requestValue)	Specifies the value for the request associated with this extended operation.
void	setResponseOID(String responseOID)	Specifies the OID to include in the response to the client.
void	setResponseValue(ByteString responseValue)	Specifies the value to include in the response to the client.
void	toString(StringBuilder buffer)	Appends a string representation of this operation to the provided buffer.

Methods inherited from class org.opends.server.types.AbstractOperation

abort, addAdditionalLogItem, addRequestControl, appendErrorMessage, appendMaskedErrorMessage, cancel, checkIfCanceled, disconnectClient, dontSynchronize, equals, getAdditionalLogItems, getAttachment, getAttachments, getAuthorizationDN, getAuthorizationEntry, getCancelRequest, getCancelResult, getClientConnection, getConnectionID, getErrorMessage, getMaskedErrorMessage, getMaskedResultCode, getMatchedDN, getMessageID, getOperationID, getProcessingNanoTime, getProcessingStartTime, getProcessingStopTime, getProcessingTime, getReferralURLs, getRequestControl, getRequestControls, getResultCode, getTransactionId, hashCode, invokePostResponseCallbacks, isInnerOperation, isInternalOperation, isSynchronizationOperation, operationCompleted, processOperationResult, processOperationResult, registerPostResponseCallback, removeAttachment, setAttachment, setAttachments, setAuthorizationEntry, setDontSynchronize, setErrorMessage, setInnerOperation, setInternalOperation, setMaskedErrorMessage, setMaskedResultCode, setMatchedDN, setProcessingStartTime, setProcessingStopTime, setReferralURLs, setResponseData, setResultCode, setSynchronizationOperation, toString, updateOperationErrMsgAndResCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.opends.server.types.Operation

abort, addAdditionalLogItem, addRequestControl, appendErrorMessage, appendMaskedErrorMessage, cancel, checkIfCanceled, disconnectClient, dontSynchronize, getAdditionalLogItems, getAttachment, getAttachments, getAuthorizationDN, getAuthorizationEntry, getCancelRequest, getCancelResult, getClientConnection, getConnectionID, getErrorMessage, getMaskedErrorMessage, getMaskedResultCode, getMatchedDN, getMessageID, getOperationID, getProcessingNanoTime, getProcessingStartTime, getProcessingStopTime, getProcessingTime, getReferralURLs, getRequestControl, getRequestControls, getResultCode, isInnerOperation, isInternalOperation, isSynchronizationOperation, operationCompleted, registerPostResponseCallback, removeAttachment, setAttachment, setAttachments, setAuthorizationEntry, setDontSynchronize, setErrorMessage, setInnerOperation, setInternalOperation, setMaskedErrorMessage, setMaskedResultCode, setMatchedDN, setReferralURLs, setResponseData, setResultCode, setSynchronizationOperation, toString

Methods inherited from interface org.opends.server.types.operation.PluginOperation

checkIfCanceled, disconnectClient, getAttachment, getAttachments, getClientConnection, getConnectionID, getMessageID, getOperationID, getProcessingStartTime, getRequestControl, getRequestControls, isInternalOperation, isSynchronizationOperation, removeAttachment, setAttachment, toString

Methods inherited from interface org.opends.server.types.operation.PostOperationOperation

addAdditionalLogItem, appendErrorMessage, getAdditionalLogItems, getAuthorizationDN, getErrorMessage, getMatchedDN, getReferralURLs, getResultCode, setErrorMessage, setMatchedDN, setReferralURLs, setResponseData, setResultCode

Methods inherited from interface org.opends.server.types.operation.PreOperationOperation

addAdditionalLogItem, appendErrorMessage, getAdditionalLogItems, getAuthorizationDN, getErrorMessage, setErrorMessage

Methods inherited from interface org.opends.server.types.operation.PreParseOperation

addAdditionalLogItem, addRequestControl, appendErrorMessage, getAdditionalLogItems, getErrorMessage, setErrorMessage

Constructor Detail

ExtendedOperationBasis

public ExtendedOperationBasis(ClientConnection clientConnection,
                              long operationID,
                              int messageID,
                              List<Control> requestControls,
                              String requestOID,
                              ByteString requestValue)

Creates a new extended operation with the provided information.

Parameters:

clientConnection - The client connection with which this operation is associated.

operationID - The operation ID for this operation.

messageID - The message ID of the request with which this operation is associated.

requestControls - The set of controls included in the request.

requestOID - The OID for the request associated with this extended operation.

requestValue - The value for the request associated with this extended operation.

Method Detail

getRequestOID

public final String getRequestOID()

Description copied from interface: ExtendedOperation

Retrieves the OID for the request associated with this extended operation.

Specified by:

getRequestOID in interface ExtendedOperation

Specified by:

getRequestOID in interface PostOperationExtendedOperation

Specified by:

getRequestOID in interface PostResponseExtendedOperation

Specified by:

getRequestOID in interface PreOperationExtendedOperation

Specified by:

getRequestOID in interface PreParseExtendedOperation

Returns:

The OID for the request associated with this extended operation.

setRequestOID

public final void setRequestOID(String requestOID)

Specifies the OID for the request associated with this extended operation. This should only be called by pre-parse plugins.

Specified by:

setRequestOID in interface PreParseExtendedOperation

Parameters:

requestOID - The OID for the request associated with this extended operation.

getProxiedAuthorizationDN

public DN getProxiedAuthorizationDN()

Description copied from interface: Operation

Retrieves the proxied authorization DN for this operation if proxied authorization has been requested.

Specified by:

getProxiedAuthorizationDN in interface Operation

Returns:

The proxied authorization DN for this operation if proxied authorization has been requested, or null if proxied authorization has not been requested.

setProxiedAuthorizationDN

public void setProxiedAuthorizationDN(DN proxiedAuthorizationDN)

Description copied from interface: Operation

Set the proxied authorization DN for this operation if proxied authorization has been requested.

Specified by:

setProxiedAuthorizationDN in interface Operation

Parameters:

proxiedAuthorizationDN - The proxied authorization DN for this operation if proxied authorization has been requested, or null if proxied authorization has not been requested.

getRequestValue

public final ByteString getRequestValue()

Description copied from interface: ExtendedOperation

Retrieves the value for the request associated with this extended operation.

Specified by:

getRequestValue in interface ExtendedOperation

Specified by:

getRequestValue in interface PostOperationExtendedOperation

Specified by:

getRequestValue in interface PostResponseExtendedOperation

Specified by:

getRequestValue in interface PreOperationExtendedOperation

Specified by:

getRequestValue in interface PreParseExtendedOperation

Returns:

The value for the request associated with this extended operation.

setRequestValue

public final void setRequestValue(ByteString requestValue)

Specifies the value for the request associated with this extended operation. This should only be called by pre-parse plugins.

Specified by:

setRequestValue in interface PreParseExtendedOperation

Parameters:

requestValue - The value for the request associated with this extended operation.

getResponseOID

public final String getResponseOID()

Description copied from interface: ExtendedOperation

Retrieves the OID to include in the response to the client.

Specified by:

getResponseOID in interface ExtendedOperation

Specified by:

getResponseOID in interface PostOperationExtendedOperation

Specified by:

getResponseOID in interface PostResponseExtendedOperation

Returns:

The OID to include in the response to the client.

setResponseOID

public final void setResponseOID(String responseOID)

Description copied from interface: ExtendedOperation

Specifies the OID to include in the response to the client.

Specified by:

setResponseOID in interface ExtendedOperation

Specified by:

setResponseOID in interface PostOperationExtendedOperation

Specified by:

setResponseOID in interface PreOperationExtendedOperation

Specified by:

setResponseOID in interface PreParseExtendedOperation

Parameters:

responseOID - The OID to include in the response to the client.

getResponseValue

public final ByteString getResponseValue()

Description copied from interface: ExtendedOperation

Retrieves the value to include in the response to the client.

Specified by:

getResponseValue in interface ExtendedOperation

Specified by:

getResponseValue in interface PostOperationExtendedOperation

Specified by:

getResponseValue in interface PostResponseExtendedOperation

Returns:

The value to include in the response to the client.

setResponseValue

public final void setResponseValue(ByteString responseValue)

Description copied from interface: ExtendedOperation

Specifies the value to include in the response to the client.

Specified by:

setResponseValue in interface ExtendedOperation

Specified by:

setResponseValue in interface PostOperationExtendedOperation

Specified by:

setResponseValue in interface PreOperationExtendedOperation

Specified by:

setResponseValue in interface PreParseExtendedOperation

Parameters:

responseValue - The value to include in the response to the client.

getOperationType

public final OperationType getOperationType()

Description copied from interface: Operation

Retrieves the operation type for this operation.

Specified by:

getOperationType in interface Operation

Specified by:

getOperationType in interface PluginOperation

Returns:

The operation type for this operation.

getResponseControls

public final List<Control> getResponseControls()

Description copied from interface: Operation

Retrieves the set of controls to include in the response to the client. The contents of this list must not be altered.

Specified by:

getResponseControls in interface Operation

Specified by:

getResponseControls in interface PluginOperation

Returns:

The set of controls to include in the response to the client.

addResponseControl

public final void addResponseControl(Control control)

Description copied from interface: Operation

Adds the provided control to the set of controls to include in the response to the client. This method may not be called by post-response plugins.

Specified by:

addResponseControl in interface Operation

Specified by:

addResponseControl in interface PostOperationOperation

Specified by:

addResponseControl in interface PreOperationOperation

Specified by:

addResponseControl in interface PreParseOperation

Parameters:

control - The control to add to the set of controls to include in the response to the client.

removeResponseControl

public final void removeResponseControl(Control control)

Description copied from interface: Operation

Removes the provided control from the set of controls to include in the response to the client. This method may not be called by post-response plugins.

Specified by:

removeResponseControl in interface Operation

Specified by:

removeResponseControl in interface PostOperationOperation

Specified by:

removeResponseControl in interface PreOperationOperation

Specified by:

removeResponseControl in interface PreParseOperation

Parameters:

control - The control to remove from the set of controls to include in the response to the client.

run

public final void run()

Performs the work of actually processing this operation. This should include all processing for the operation, including invoking plugins, logging messages, performing access control, managing synchronization, and any other work that might need to be done in the course of processing.

Specified by:

run in interface Operation

Specified by:

run in interface Runnable

toString

public final void toString(StringBuilder buffer)

Description copied from interface: Operation

Appends a string representation of this operation to the provided buffer.

Specified by:

toString in interface Operation

Specified by:

toString in interface PluginOperation

Parameters:

buffer - The buffer into which a string representation of this operation should be appended.