Package org.opends.server.core

Class ModifyOperation

java.lang.Object

org.opends.server.types.Operation

org.opends.server.core.ModifyOperation

All Implemented Interfaces:

Runnable, PluginOperation, PostOperationModifyOperation, PostOperationOperation, PostResponseModifyOperation, PostResponseOperation, PostSynchronizationModifyOperation, PostSynchronizationOperation, PreOperationModifyOperation, PreOperationOperation, PreParseModifyOperation, PreParseOperation

public final class ModifyOperation
extends Operation
implements PreOperationModifyOperation, PreParseModifyOperation, PostOperationModifyOperation, PostResponseModifyOperation, PostSynchronizationModifyOperation

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

requestContext

Constructor Summary

Constructors

Constructor	Description
ModifyOperation(org.forgerock.services.context.Context context, ModifyRequest modifyRequest)	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	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.
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	setEntryDN(Dn entryDN)	Specifies the entry DN as included in the client request.
void	setModifications(List<Modification> modifications)	Specifies the set of modifications for this modify operation.
void	setProxiedAuthorizationDN(Dn proxiedAuthorizationDN)	Set the proxied authorization DN for this operation if proxied authorization has been requested.
void	toString(StringBuilder buffer)	Appends a string representation of this operation to the provided buffer.

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

addAdditionalLogItem, addPasswordPolicyWarningToLog, addPostReadResponse, addPreReadResponse, addRequestControl, appendErrorMessage, appendMaskedErrorMessage, checkAttributeConformsToSyntax, checkIfBackendIsWritable, checkIfCanceled, createLdapException, disconnectClient, dontSynchronize, equals, evaluateProxyAuthControls, filterNonDisclosableMatchedDN, findMatchedDN, getAdditionalLogItems, getAttachment, getAttachments, getAuthorizationDN, getAuthorizationEntry, getClientConnection, getConnectionID, getContext, getErrorMessage, getLargestEntrySize, getLocalBackend, getMatchedDN, getMessageID, getOperationID, getReferralURLs, getRequestControl, getRequestControls, getResultCode, getServerContext, hashCode, hasPrivilege, hasRequestControl, invokePostResponseCallbacks, isHumanReadable, isInnerOperation, isInternalOperation, isProxyAuthzControl, isSynchronizationOperation, mustCheckSchema, operationCompleted, processOperationResult, processOperationResult, registerPostResponseCallback, removeAllDisallowedControls, removeAttachment, setAttachment, setAttachments, setAuthorizationEntry, setDontSynchronize, setErrorMessage, setInnerOperation, setInternalOperation, setMatchedDN, setReferralURLs, setResult, setResult, setResultCode, setResultCodeAndMessageNoInfoDisclosure, setSynchronizationOperation, toString, trySetLargestEntrySize

Methods inherited from class java.lang.Object

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

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

checkIfCanceled, disconnectClient, getAttachment, getAttachments, getClientConnection, getConnectionID, getMessageID, getOperationID, getRequestControl, 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, setResult, setResultCode

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

getAdditionalLogItems, getAuthorizationDN, getErrorMessage, getMatchedDN, getReferralURLs, getResultCode

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

getAdditionalLogItems, getAuthorizationDN, getErrorMessage, getMatchedDN, getReferralURLs, getResultCode

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

ModifyOperation

public ModifyOperation(org.forgerock.services.context.Context context,
                       ModifyRequest modifyRequest)

Creates a new modify operation with the provided information.

Parameters:

context - The context with which this operation is associated.

modifyRequest - The modify request.

Method Detail

setEntryDN

public void setEntryDN(Dn entryDN)

Description copied from interface: PreParseModifyOperation

Specifies the entry DN as included in the client request.

Specified by:

setEntryDN in interface PreParseModifyOperation

Parameters:

entryDN - The entry DN as included in the client request.

getEntryDN

public Dn getEntryDN()

Description copied from interface: PreOperationModifyOperation

Retrieves the DN of the entry to modify.

Specified by:

getEntryDN in interface PostOperationModifyOperation

Specified by:

getEntryDN in interface PostResponseModifyOperation

Specified by:

getEntryDN in interface PostSynchronizationModifyOperation

Specified by:

getEntryDN in interface PreOperationModifyOperation

Specified by:

getEntryDN in interface PreParseModifyOperation

Returns:

The DN of the entry to modify.

setModifications

public void setModifications(List<Modification> modifications)

Description copied from interface: PreParseModifyOperation

Specifies the set of modifications for this modify operation.

Specified by:

setModifications in interface PreParseModifyOperation

Parameters:

modifications - The modifications for this modify operation.

getModifications

public List<Modification> getModifications()

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 PostOperationModifyOperation

Specified by:

getModifications in interface PostResponseModifyOperation

Specified by:

getModifications in interface PostSynchronizationModifyOperation

Specified by:

getModifications in interface PreOperationModifyOperation

Specified by:

getModifications in interface PreParseModifyOperation

Returns:

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

addModification

public void addModification(Modification modification)
                     throws LdapException

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 PreOperationModifyOperation

Specified by:

addModification in interface PreParseModifyOperation

Parameters:

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

Throws:

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

getOperationType

public OperationType getOperationType()

Description copied from interface: PluginOperation

Retrieves the operation type for this operation.

Specified by:

getOperationType in interface PluginOperation

Returns:

The operation type for this operation.

getProxiedAuthorizationDN

public Dn getProxiedAuthorizationDN()

Description copied from class: Operation

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

Specified by:

getProxiedAuthorizationDN in class 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 List<Control> getResponseControls()

Description copied from interface: PluginOperation

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 PluginOperation

Returns:

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

addResponseControl

public void addResponseControl(Control control)

Description copied from class: 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 PostOperationOperation

Specified by:

addResponseControl in interface PreOperationOperation

Specified by:

addResponseControl in interface PreParseOperation

Specified by:

addResponseControl in class Operation

Parameters:

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

removeResponseControl

public void removeResponseControl(Control control)

Description copied from class: 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 PostOperationOperation

Specified by:

removeResponseControl in interface PreOperationOperation

Specified by:

removeResponseControl in interface PreParseOperation

Specified by:

removeResponseControl in class Operation

Parameters:

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

toString

public void toString(StringBuilder buffer)

Description copied from interface: PluginOperation

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

Specified by:

toString in interface PluginOperation

Specified by:

toString in class Operation

Parameters:

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

setProxiedAuthorizationDN

public void setProxiedAuthorizationDN(Dn proxiedAuthorizationDN)

Description copied from class: Operation

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

Specified by:

setProxiedAuthorizationDN in class 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 void run()

Description copied from class: 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 Runnable

Specified by:

run in class Operation

getCurrentEntry

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