Package org.opends.server.workflowelement.localbackend

Class LocalBackendModifyOperation

java.lang.Object

org.opends.server.core.OperationWrapper<ModifyOperation>

org.opends.server.core.ModifyOperationWrapper

org.opends.server.workflowelement.localbackend.LocalBackendModifyOperation

All Implemented Interfaces:

Runnable, ModifyOperation, Operation, PluginOperation, PostOperationModifyOperation, PostOperationOperation, PostResponseModifyOperation, PostResponseOperation, PostSynchronizationModifyOperation, PostSynchronizationOperation, PreOperationModifyOperation, PreOperationOperation, RollbackOperation

public class LocalBackendModifyOperation
extends ModifyOperationWrapper
implements PreOperationModifyOperation, PostOperationModifyOperation, PostResponseModifyOperation, PostSynchronizationModifyOperation, RollbackOperation

This class defines an operation used to modify an entry in a local backend of the Directory Server.

Field Summary

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

LOCALBACKENDOPERATIONS

Constructor Summary

Constructors

Constructor	Description
LocalBackendModifyOperation(ModifyOperation modify)	Creates a new operation that may be used to modify an entry in a local backend of the Directory Server.

Method Summary

Modifier and Type	Method	Description
void	addModification(Modification modification)	Adds the provided modification to the set of modifications to this modify operation.
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.
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.
void	rollback()

Methods inherited from class org.opends.server.core.ModifyOperationWrapper

addRawModification, getEntryDN, getModifications, getRawEntryDN, getRawModifications, setRawEntryDN, setRawModifications, toString

Methods inherited from class org.opends.server.core.OperationWrapper

abort, addAdditionalLogItem, addRequestControl, addResponseControl, appendErrorMessage, appendMaskedErrorMessage, cancel, checkIfCanceled, disconnectClient, dontSynchronize, equals, getAdditionalLogItems, getAttachment, getAttachments, getAuthorizationDN, getAuthorizationEntry, getCancelRequest, getCancelResult, getClientConnection, getConnectionID, getErrorMessage, getMaskedErrorMessage, getMaskedResultCode, getMatchedDN, getMessageID, getOperation, getOperationID, getOperationType, getProcessingNanoTime, getProcessingStartTime, getProcessingStopTime, getProcessingTime, getProxiedAuthorizationDN, getReferralURLs, getRequestControl, getRequestControls, getResponseControls, getResultCode, hashCode, isInnerOperation, isInternalOperation, isSynchronizationOperation, operationCompleted, registerPostResponseCallback, removeAttachment, removeResponseControl, run, setAttachment, setAttachments, setAuthorizationEntry, setDontSynchronize, setErrorMessage, setInnerOperation, setInternalOperation, setMaskedErrorMessage, setMaskedResultCode, setMatchedDN, setProxiedAuthorizationDN, 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.core.ModifyOperation

getProxiedAuthorizationDN, setProxiedAuthorizationDN

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

abort, addAdditionalLogItem, addRequestControl, addResponseControl, appendErrorMessage, appendMaskedErrorMessage, cancel, checkIfCanceled, disconnectClient, dontSynchronize, getAdditionalLogItems, getAttachment, getAttachments, getAuthorizationDN, getAuthorizationEntry, getCancelRequest, getCancelResult, getClientConnection, getConnectionID, getErrorMessage, getMaskedErrorMessage, getMaskedResultCode, getMatchedDN, getMessageID, getOperationID, getOperationType, getProcessingNanoTime, getProcessingStartTime, getProcessingStopTime, getProcessingTime, getReferralURLs, getRequestControl, getRequestControls, getResponseControls, getResultCode, isInnerOperation, isInternalOperation, isSynchronizationOperation, operationCompleted, registerPostResponseCallback, removeAttachment, removeResponseControl, run, 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, getOperationType, getProcessingStartTime, getRequestControl, getRequestControls, getResponseControls, isInternalOperation, isSynchronizationOperation, removeAttachment, setAttachment, toString, toString

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

getEntryDN, getModifications, getRawEntryDN, getRawModifications

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

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

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

getEntryDN, getModifications, getRawEntryDN, getRawModifications

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

getEntryDN, getModifications, getRawEntryDN, getRawModifications

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

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

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

getEntryDN, getModifications, getRawEntryDN, getRawModifications

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

addAdditionalLogItem, addResponseControl, appendErrorMessage, getAdditionalLogItems, getAuthorizationDN, getErrorMessage, removeResponseControl, setErrorMessage

Constructor Detail

LocalBackendModifyOperation

public LocalBackendModifyOperation(ModifyOperation modify)

Creates a new operation that may be used to modify an entry in a local backend of the Directory Server.

Parameters:

modify - The operation to enhance.

Method Detail

getCurrentEntry

public final Entry getCurrentEntry()

Retrieves the current entry before any modifications are applied. This will not be available to pre-parse plugins.

Specified by:

getCurrentEntry in interface PostOperationModifyOperation

Specified by:

getCurrentEntry in interface PostResponseModifyOperation

Specified by:

getCurrentEntry in interface PostSynchronizationModifyOperation

Specified by:

getCurrentEntry in interface PreOperationModifyOperation

Returns:

The current entry, or null if it is not yet available.

getCurrentPasswords

public final 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. It will not be available to pre-parse plugins.

Specified by:

getCurrentPasswords in interface PostOperationModifyOperation

Specified by:

getCurrentPasswords in interface PostResponseModifyOperation

Specified by:

getCurrentPasswords in interface PostSynchronizationModifyOperation

Specified by:

getCurrentPasswords in interface PreOperationModifyOperation

Returns:

The set of clear-text current password values as provided in the modify request, or null if there were none or this information is not yet available.

getModifiedEntry

public final Entry getModifiedEntry()

Retrieves the modified entry that is to be written to the backend. This will be available to pre-operation plugins, and if such a plugin does make a change to this entry, then it is also necessary to add that change to the set of modifications to ensure that the update will be consistent.

Specified by:

getModifiedEntry in interface PostOperationModifyOperation

Specified by:

getModifiedEntry in interface PostResponseModifyOperation

Specified by:

getModifiedEntry in interface PostSynchronizationModifyOperation

Specified by:

getModifiedEntry in interface PreOperationModifyOperation

Returns:

The modified entry that is to be written to the backend, or null if it is not yet available.

getNewPasswords

public final 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. It will not be available to pre-parse plugins.

Specified by:

getNewPasswords in interface PostOperationModifyOperation

Specified by:

getNewPasswords in interface PostResponseModifyOperation

Specified by:

getNewPasswords in interface PostSynchronizationModifyOperation

Specified by:

getNewPasswords in interface PreOperationModifyOperation

Returns:

The set of clear-text new passwords as provided in the modify request, or null if there were none or this information is not yet available.

addModification

public void addModification(Modification modification)
                     throws DirectoryException

Adds the provided modification to the set of modifications to this modify operation. In addition, the modification is applied to the modified entry.

This may only be called by pre-operation plugins.

Specified by:

addModification in interface ModifyOperation

Specified by:

addModification in interface PreOperationModifyOperation

Overrides:

addModification in class ModifyOperationWrapper

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.

rollback

public void rollback()
              throws CanceledOperationException,
                     DirectoryException

Specified by:

rollback in interface RollbackOperation

Throws:

CanceledOperationException

DirectoryException