Package org.opends.server.core

Class ModifyOperationBasis

java.lang.Object

org.opends.server.types.AbstractOperation

org.opends.server.core.ModifyOperationBasis

All Implemented Interfaces:

Runnable, ModifyOperation, Operation, PluginOperation, PostResponseModifyOperation, PostResponseOperation, PreParseModifyOperation, PreParseOperation

public class ModifyOperationBasis
extends AbstractOperation
implements ModifyOperation, PreParseModifyOperation, PostResponseModifyOperation

This class defines an operation that may be used to modify an entry in the Directory Server.

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
ModifyOperationBasis(ClientConnection clientConnection, long operationID, int messageID, List<Control> requestControls, ByteString rawEntryDN, List<RawModification> rawModifications)	Creates a new modify operation with the provided information.
ModifyOperationBasis(ClientConnection clientConnection, long operationID, int messageID, List<Control> requestControls, DN entryDN, List<Modification> modifications)	Creates a new modify operation with the provided information.

Method Summary

Modifier and Type	Method	Description
void	addModification(Modification modification)	Adds the provided modification to the set of modifications to this modify operation.
void	addRawModification(RawModification rawModification)	Adds the provided modification to the set of raw modifications for this modify operation.
void	addResponseControl(Control control)	Adds the provided control to the set of controls to include in the response to the client.
Entry	getCurrentEntry()	Retrieves the current entry before any modifications are applied.
List<ByteString>	getCurrentPasswords()	Retrieves the set of clear-text current passwords for the user, if available.
DN	getEntryDN()	Retrieves the DN of the entry to modify.
List<Modification>	getModifications()	Retrieves the set of modifications for this modify operation.
Entry	getModifiedEntry()	Retrieves the modified entry that is to be written to the backend.
List<ByteString>	getNewPasswords()	Retrieves the set of clear-text new passwords for the user, if available.
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.
ByteString	getRawEntryDN()	Retrieves the raw, unprocessed entry DN as included in the client request.
List<RawModification>	getRawModifications()	Retrieves the set of raw, unprocessed modifications as included in the client request.
List<Control>	getResponseControls()	Retrieves the set of controls 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	setRawEntryDN(ByteString rawEntryDN)	Specifies the raw, unprocessed entry DN as included in the client request.
void	setRawModifications(List<RawModification> rawModifications)	Specifies the raw modifications for this modify operation.
void	toString(StringBuilder buffer)	Appends a string representation of this operation to the provided buffer.
void	updateOperationErrMsgAndResCode()	Updates the error message and the result code of the operation.

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

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.PostResponseOperation

getAdditionalLogItems, getAuthorizationDN, getErrorMessage, getMatchedDN, getProcessingStopTime, getProcessingTime, getReferralURLs, getResultCode

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

addAdditionalLogItem, addRequestControl, appendErrorMessage, getAdditionalLogItems, getErrorMessage, setErrorMessage

Constructor Detail

ModifyOperationBasis

public ModifyOperationBasis(ClientConnection clientConnection,
                            long operationID,
                            int messageID,
                            List<Control> requestControls,
                            ByteString rawEntryDN,
                            List<RawModification> rawModifications)

Creates a new modify 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.

rawEntryDN - The raw, unprocessed DN of the entry to modify, as included in the client request.

rawModifications - The raw, unprocessed set of modifications for this modify operation as included in the client request.

ModifyOperationBasis

public ModifyOperationBasis(ClientConnection clientConnection,
                            long operationID,
                            int messageID,
                            List<Control> requestControls,
                            DN entryDN,
                            List<Modification> modifications)

Creates a new modify 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.

entryDN - The entry DN for the modify operation.

modifications - The set of modifications for this modify operation.

Method Detail

getRawEntryDN

public final ByteString getRawEntryDN()

Description copied from interface: ModifyOperation

Retrieves the raw, unprocessed entry DN as included in the client request. The DN that is returned may or may not be a valid DN, since no validation will have been performed upon it.

Specified by:

getRawEntryDN in interface ModifyOperation

Specified by:

getRawEntryDN in interface PostResponseModifyOperation

Specified by:

getRawEntryDN in interface PreParseModifyOperation

Returns:

The raw, unprocessed entry DN as included in the client request.

setRawEntryDN

public final void setRawEntryDN(ByteString rawEntryDN)

Description copied from interface: ModifyOperation

Specifies the raw, unprocessed entry DN as included in the client request. This should only be called by pre-parse plugins.

Specified by:

setRawEntryDN in interface ModifyOperation

Specified by:

setRawEntryDN in interface PreParseModifyOperation

Parameters:

rawEntryDN - The raw, unprocessed entry DN as included in the client request.

getEntryDN

public final DN getEntryDN()

Description copied from interface: ModifyOperation

Retrieves the DN of the entry to modify. This should not be called by pre-parse plugins because the processed DN will not be available yet. Instead, they should call the getRawEntryDN method.

Specified by:

getEntryDN in interface ModifyOperation

Specified by:

getEntryDN in interface PostResponseModifyOperation

Returns:

The DN of the entry to modify, or null if the raw entry DN has not yet been processed.

getRawModifications

public final List<RawModification> getRawModifications()

Description copied from interface: ModifyOperation

Retrieves the set of raw, unprocessed modifications as included in the client request. Note that this may contain one or more invalid modifications, as no validation will have been performed on this information. The list returned must not be altered by the caller.

Specified by:

getRawModifications in interface ModifyOperation

Specified by:

getRawModifications in interface PostResponseModifyOperation

Specified by:

getRawModifications in interface PreParseModifyOperation

Returns:

The set of raw, unprocessed modifications as included in the client request.

addRawModification

public final void addRawModification(RawModification rawModification)

Description copied from interface: ModifyOperation

Adds the provided modification to the set of raw modifications for this modify operation. This must only be called by pre-parse plugins.

Specified by:

addRawModification in interface ModifyOperation

Specified by:

addRawModification in interface PreParseModifyOperation

Parameters:

rawModification - The modification to add to the set of raw modifications for this modify operation.

setRawModifications

public final void setRawModifications(List<RawModification> rawModifications)

Description copied from interface: ModifyOperation

Specifies the raw modifications for this modify operation.

Specified by:

setRawModifications in interface ModifyOperation

Specified by:

setRawModifications in interface PreParseModifyOperation

Parameters:

rawModifications - The raw modifications for this modify operation.

getModifications

public final List<Modification> getModifications()

Description copied from interface: ModifyOperation

Retrieves the set of modifications for this modify operation. Its contents should not be altered. It will not be available to pre-parse plugins.

Specified by:

getModifications in interface ModifyOperation

Specified by:

getModifications in interface PostResponseModifyOperation

Returns:

The set of modifications for this modify operation, or null if the modifications have not yet been processed.

addModification

public final void addModification(Modification modification)
                           throws DirectoryException

Description copied from interface: ModifyOperation

Adds the provided modification to the set of modifications to this modify operation. This may only be called by pre-operation plugins.

Specified by:

addModification in interface ModifyOperation

Parameters:

modification - The modification to add to the set of changes for this modify operation.

Throws:

DirectoryException - If an unexpected problem occurs while applying the modification to the entry.

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.

getProxiedAuthorizationDN

public DN getProxiedAuthorizationDN()

Description copied from interface: ModifyOperation

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

Specified by:

getProxiedAuthorizationDN in interface ModifyOperation

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.

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 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 PreParseOperation

Parameters:

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

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.

setProxiedAuthorizationDN

public void setProxiedAuthorizationDN(DN proxiedAuthorizationDN)

Description copied from interface: ModifyOperation

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

Specified by:

setProxiedAuthorizationDN in interface ModifyOperation

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.

run

public final void run()

Description copied from interface: Operation

Performs the work of actually processing this operation. This should include all processing for the operation, including invoking pre-parse and post-response plugins, logging messages 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

updateOperationErrMsgAndResCode

public void updateOperationErrMsgAndResCode()

Description copied from class: AbstractOperation

Updates the error message and the result code of the operation. This method is called because no workflows were found to process the operation.

Overrides:

updateOperationErrMsgAndResCode in class AbstractOperation

getCurrentEntry

public Entry getCurrentEntry()

Retrieves the current entry before any modifications are applied. It should not be modified by the caller. This method always returns null.

Specified by:

getCurrentEntry in interface PostResponseModifyOperation

Returns:

The current entry before any modifications are applied.

getCurrentPasswords

public List<ByteString> getCurrentPasswords()

Retrieves the set of clear-text current passwords for the user, if available. This will only be available if the modify operation contains one or more delete elements that target the password attribute and provide the values to delete in the clear. This list should not be altered by the caller. This method always returns null.

Specified by:

getCurrentPasswords in interface PostResponseModifyOperation

Returns:

The set of clear-text current password values as provided in the modify request, or null if there were none.

getModifiedEntry

public Entry getModifiedEntry()

Retrieves the modified entry that is to be written to the backend. It should not be modified by the caller. This method always returns null.

Specified by:

getModifiedEntry in interface PostResponseModifyOperation

Returns:

The modified entry that is to be written to the backend.

getNewPasswords

public List<ByteString> getNewPasswords()

Retrieves the set of clear-text new passwords for the user, if available. This will only be available if the modify operation contains one or more add or replace elements that target the password attribute and provide the values in the clear. This list should not be altered by the caller. This method always returns null.

Specified by:

getNewPasswords in interface PostResponseModifyOperation

Returns:

The set of clear-text new passwords as provided in the modify request, or null if there were none.