org.opends.server.core
Interface ModifyOperation

All Superinterfaces:
Operation
All Known Implementing Classes:
LocalBackendModifyOperation, ModifyOperationBasis, ModifyOperationWrapper

public interface ModifyOperation
extends Operation

This interface defines an operation used to modify an entry in the Directory Server.


Field Summary
 
Fields inherited from interface org.opends.server.types.Operation
LOCALBACKENDOPERATIONS
 
Method Summary
 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.
 long getChangeNumber()
          Retrieves the change number that has been assigned to this operation.
 DN getEntryDN()
          Retrieves the DN of the entry to modify.
 java.util.List<Modification> getModifications()
          Retrieves the set of modifications for this modify 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.
 java.util.List<RawModification> getRawModifications()
          Retrieves the set of raw, unprocessed modifications as included in the client request.
 void setChangeNumber(long changeNumber)
          Specifies the change number that has been assigned to this operation by the synchronization mechanism.
 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(java.util.List<RawModification> rawModifications)
          Specifies the raw modifications for this modify operation.
 
Methods inherited from interface org.opends.server.types.Operation
abort, addRequestControl, addResponseControl, appendAdditionalLogMessage, appendErrorMessage, cancel, checkIfCanceled, disconnectClient, dontSynchronize, getAdditionalLogMessage, getAttachment, getAttachments, getAuthorizationDN, getAuthorizationEntry, getCancelRequest, getCancelResult, getClientConnection, getCommonLogElements, getConnectionID, getErrorMessage, getMatchedDN, getMessageID, getOperationID, getOperationType, getProcessingNanoTime, getProcessingStartTime, getProcessingStopTime, getProcessingTime, getReferralURLs, getRequestControls, getRequestLogElements, getResponseControls, getResponseLogElements, getResultCode, isInternalOperation, isSynchronizationOperation, operationCompleted, removeAttachment, removeRequestControl, removeResponseControl, setAdditionalLogMessage, setAttachment, setAttachments, setAuthorizationEntry, setDontSynchronize, setErrorMessage, setInternalOperation, setMatchedDN, setReferralURLs, setResponseData, setResultCode, setSynchronizationOperation, toString, toString
 

Method Detail

getRawEntryDN

ByteString getRawEntryDN()
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.

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

setRawEntryDN

void setRawEntryDN(ByteString rawEntryDN)
Specifies the raw, unprocessed entry DN as included in the client request. This should only be called by pre-parse plugins.

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

getEntryDN

DN getEntryDN()
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.

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

getRawModifications

java.util.List<RawModification> getRawModifications()
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.

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

addRawModification

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

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

setRawModifications

void setRawModifications(java.util.List<RawModification> rawModifications)
Specifies the raw modifications for this modify operation.

Parameters:
rawModifications - The raw modifications for this modify operation.

getModifications

java.util.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.

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

addModification

void addModification(Modification modification)
                     throws DirectoryException
Adds the provided modification to the set of modifications to this modify operation. This may only be called by pre-operation plugins.

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.

getChangeNumber

long getChangeNumber()
Retrieves the change number that has been assigned to this operation.

Returns:
The change number that has been assigned to this operation, or -1 if none has been assigned yet or if there is no applicable synchronization mechanism in place that uses change numbers.

setChangeNumber

void setChangeNumber(long changeNumber)
Specifies the change number that has been assigned to this operation by the synchronization mechanism.

Parameters:
changeNumber - The change number that has been assigned to this operation by the synchronization mechanism.

getProxiedAuthorizationDN

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

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

setProxiedAuthorizationDN

void setProxiedAuthorizationDN(DN proxiedAuthorizationDN)
Set the proxied authorization DN for this operation if proxied authorization has been requested.

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