org.opends.server.types.operation
Interface PostOperationOperation

All Superinterfaces:
PluginOperation
All Known Subinterfaces:
PostOperationAbandonOperation, PostOperationAddOperation, PostOperationBindOperation, PostOperationCompareOperation, PostOperationDeleteOperation, PostOperationExtendedOperation, PostOperationModifyDNOperation, PostOperationModifyOperation, PostOperationSearchOperation, PostOperationUnbindOperation, PostResponseBindOperation, PostResponseExtendedOperation
All Known Implementing Classes:
AbandonOperationBasis, ExtendedOperationBasis, LocalBackendAddOperation, LocalBackendBindOperation, LocalBackendCompareOperation, LocalBackendDeleteOperation, LocalBackendModifyDNOperation, LocalBackendModifyOperation, LocalBackendSearchOperation, UnbindOperationBasis

@PublicAPI(stability=UNCOMMITTED,
           mayInstantiate=false,
           mayExtend=false,
           mayInvoke=true)
public interface PostOperationOperation
extends PluginOperation

This class defines a set of methods that are available for use by post-operation plugins for all types of operations. Note that this interface is intended only to define an API for use by plugins and is not intended to be implemented by any custom classes.


Method Summary
 void addResponseControl(Control control)
          Adds the provided control to the set of controls to include in the response to the client.
 void appendAdditionalLogMessage(Message message)
          Appends the provided message to the additional log information for this operation.
 void appendErrorMessage(Message message)
          Appends the provided message to the error message buffer.
 MessageBuilder getAdditionalLogMessage()
          Retrieves the additional log message for this operation, which should be written to the log but not included in the response to the client.
 DN getAuthorizationDN()
          Retrieves the authorization DN for this operation.
 MessageBuilder getErrorMessage()
          Retrieves the error message for this operation.
 DN getMatchedDN()
          Retrieves the matched DN for this operation.
 java.util.List<java.lang.String> getReferralURLs()
          Retrieves the set of referral URLs for this operation.
 ResultCode getResultCode()
          Retrieves the result code for this operation.
 void removeResponseControl(Control control)
          Removes the provided control from the set of controls to include in the response to the client.
 void setAdditionalLogMessage(MessageBuilder additionalLogMessage)
          Specifies the additional log message for this operation, which should be written to the log but not included in the response to the client.
 void setErrorMessage(MessageBuilder errorMessage)
          Specifies the error message for this operation.
 void setMatchedDN(DN matchedDN)
          Specifies the matched DN for this operation.
 void setReferralURLs(java.util.List<java.lang.String> referralURLs)
          Specifies the set of referral URLs for this operation.
 void setResponseData(DirectoryException directoryException)
          Sets the response elements for this operation based on the information contained in the provided DirectoryException object.
 void setResultCode(ResultCode resultCode)
          Specifies the result code for this operation.
 
Methods inherited from interface org.opends.server.types.operation.PluginOperation
checkIfCanceled, disconnectClient, getAttachment, getAttachments, getClientConnection, getConnectionID, getMessageID, getOperationID, getOperationType, getProcessingStartTime, getRequestControls, getResponseControls, isInternalOperation, isSynchronizationOperation, removeAttachment, setAttachment, toString, toString
 

Method Detail

addResponseControl

void addResponseControl(Control control)
Adds the provided control to the set of controls to include in the response to the client.

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

removeResponseControl

void removeResponseControl(Control control)
Removes the provided control from the set of controls to include in the response to the client.

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

getResultCode

ResultCode getResultCode()
Retrieves the result code for this operation.

Returns:
The result code associated for this operation, or UNDEFINED if the operation has not yet completed.

setResultCode

void setResultCode(ResultCode resultCode)
Specifies the result code for this operation.

Parameters:
resultCode - The result code for this operation.

getErrorMessage

MessageBuilder getErrorMessage()
Retrieves the error message for this operation. Its contents may be altered by the caller.

Returns:
The error message for this operation.

setErrorMessage

void setErrorMessage(MessageBuilder errorMessage)
Specifies the error message for this operation.

Parameters:
errorMessage - The error message for this operation.

appendErrorMessage

void appendErrorMessage(Message message)
Appends the provided message to the error message buffer. If the buffer has not yet been created, then this will create it first and then add the provided message.

Parameters:
message - The message to append to the error message

getAdditionalLogMessage

MessageBuilder getAdditionalLogMessage()
Retrieves the additional log message for this operation, which should be written to the log but not included in the response to the client. The contents of this buffer may be altered by the caller.

Returns:
The additional log message for this operation.

setAdditionalLogMessage

void setAdditionalLogMessage(MessageBuilder additionalLogMessage)
Specifies the additional log message for this operation, which should be written to the log but not included in the response to the client.

Parameters:
additionalLogMessage - The additional log message for this operation.

appendAdditionalLogMessage

void appendAdditionalLogMessage(Message message)
Appends the provided message to the additional log information for this operation.

Parameters:
message - The message that should be appended to the additional log information for this operation.

getMatchedDN

DN getMatchedDN()
Retrieves the matched DN for this operation.

Returns:
The matched DN for this operation, or null if the operation has not yet completed or does not have a matched DN.

setMatchedDN

void setMatchedDN(DN matchedDN)
Specifies the matched DN for this operation.

Parameters:
matchedDN - The matched DN for this operation.

getReferralURLs

java.util.List<java.lang.String> getReferralURLs()
Retrieves the set of referral URLs for this operation. Its contents must not be altered by the caller.

Returns:
The set of referral URLs for this operation, or null if the operation is not yet complete or does not have a set of referral URLs.

setReferralURLs

void setReferralURLs(java.util.List<java.lang.String> referralURLs)
Specifies the set of referral URLs for this operation.

Parameters:
referralURLs - The set of referral URLs for this operation.

setResponseData

void setResponseData(DirectoryException directoryException)
Sets the response elements for this operation based on the information contained in the provided DirectoryException object.

Parameters:
directoryException - The exception containing the information to use for the response elements.

getAuthorizationDN

DN getAuthorizationDN()
Retrieves the authorization DN for this operation. In many cases, it will be the same as the DN of the authenticated user for the underlying connection, or the null DN if no authentication has been performed on that connection. However, it may be some other value if special processing has been requested (e.g., the operation included a proxied authorization control).

Returns:
The authorization DN for this operation.