Package org.opends.server.core
Interface ModifyDNOperation
-
- All Superinterfaces:
InProgressOperation,Operation,PluginOperation,Runnable,SubordinateModifyDNOperation
- All Known Implementing Classes:
LocalBackendModifyDNOperation,ModifyDNOperationBasis,ModifyDNOperationWrapper
public interface ModifyDNOperation extends Operation, SubordinateModifyDNOperation
This interface defines an operation used to move an entry in the Directory Server.
-
-
Field Summary
-
Fields inherited from interface org.opends.server.types.Operation
LOCALBACKENDOPERATIONS
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description voidaddModification(Modification modification)Adds the provided modification to the set of modifications to be applied as part of the update.booleandeleteOldRDN()Indicates whether the current RDN value should be removed from the entry.DNgetEntryDN()Retrieves the DN of the entry to rename.List<Modification>getModifications()Retrieves the set of modifications applied to attributes of the target entry in the course of processing this modify DN operation.DNgetNewDN()Retrieves the new DN for the entry.RDNgetNewRDN()Retrieves the new RDN to use for the entry.DNgetNewSuperior()Retrieves the newSuperior DN for the entry.EntrygetOriginalEntry()Retrieves the current entry, before it is renamed.DNgetProxiedAuthorizationDN()Retrieves the proxied authorization DN for this operation if proxied authorization has been requested.ByteStringgetRawEntryDN()Retrieves the raw, unprocessed entry DN as included in the client request.ByteStringgetRawNewRDN()Retrieves the raw, unprocessed newRDN as included in the request from the client.ByteStringgetRawNewSuperior()Retrieves the raw, unprocessed newSuperior from the client request.EntrygetUpdatedEntry()Retrieves the new entry, as it will appear after it is renamed.voidsetDeleteOldRDN(boolean deleteOldRDN)Specifies whether the current RDN value should be removed from the entry.voidsetProxiedAuthorizationDN(DN dn)Sets the proxied authorization DN for this operation if proxied authorization has been requested.voidsetRawEntryDN(ByteString rawEntryDN)Specifies the raw, unprocessed entry DN as included in the client request.voidsetRawNewRDN(ByteString rawNewRDN)Specifies the raw, unprocessed newRDN as included in the request from the client.voidsetRawNewSuperior(ByteString rawNewSuperior)Specifies the raw, unprocessed newSuperior for this modify DN operation, as provided in the request from the client.-
Methods inherited from interface org.opends.server.types.operation.InProgressOperation
addAdditionalLogItem, addResponseControl, appendErrorMessage, getAdditionalLogItems, getAuthorizationDN, getErrorMessage, getMatchedDN, getReferralURLs, getResultCode, removeResponseControl, setErrorMessage, setMatchedDN, setReferralURLs, setResponseData, setResultCode
-
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, 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
-
-
-
-
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.- Specified by:
getRawEntryDNin interfaceSubordinateModifyDNOperation- 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 rename. This should not be called by pre-parse plugins because the processed DN will not be available yet. Instead, they should call thegetRawEntryDNmethod.- Specified by:
getEntryDNin interfaceSubordinateModifyDNOperation- Returns:
- The DN of the entry to rename, or
nullif the raw entry DN has not yet been processed.
-
getRawNewRDN
ByteString getRawNewRDN()
Retrieves the raw, unprocessed newRDN as included in the request from the client. This may or may not contain a valid RDN, as no validation will have been performed on it.- Specified by:
getRawNewRDNin interfaceSubordinateModifyDNOperation- Returns:
- The raw, unprocessed newRDN as included in the request from the client.
-
setRawNewRDN
void setRawNewRDN(ByteString rawNewRDN)
Specifies the raw, unprocessed newRDN as included in the request from the client. This should only be called by pre-parse plugins and should not be used in later stages of processing.- Parameters:
rawNewRDN- The raw, unprocessed newRDN as included in the request from the client.
-
getNewRDN
RDN getNewRDN()
Retrieves the new RDN to use for the entry. This should not be called by pre-parse plugins, because the processed newRDN will not yet be available. Pre-parse plugins should instead use thegetRawNewRDNmethod.- Specified by:
getNewRDNin interfaceSubordinateModifyDNOperation- Returns:
- The new RDN to use for the entry, or
nullif the raw newRDN has not yet been processed.
-
deleteOldRDN
boolean deleteOldRDN()
Indicates whether the current RDN value should be removed from the entry.- Specified by:
deleteOldRDNin interfaceSubordinateModifyDNOperation- Returns:
trueif the current RDN value should be removed from the entry, orfalseif not.
-
setDeleteOldRDN
void setDeleteOldRDN(boolean deleteOldRDN)
Specifies whether the current RDN value should be removed from the entry.- Parameters:
deleteOldRDN- Specifies whether the current RDN value should be removed from the entry.
-
getRawNewSuperior
ByteString getRawNewSuperior()
Retrieves the raw, unprocessed newSuperior from the client request. This may or may not contain a valid DN, as no validation will have been performed on it.- Specified by:
getRawNewSuperiorin interfaceSubordinateModifyDNOperation- Returns:
- The raw, unprocessed newSuperior from the client request, or
nullif there is none.
-
setRawNewSuperior
void setRawNewSuperior(ByteString rawNewSuperior)
Specifies the raw, unprocessed newSuperior for this modify DN operation, as provided in the request from the client. This method should only be called by pre-parse plugins.- Parameters:
rawNewSuperior- The raw, unprocessed newSuperior as provided in the request from the client.
-
getNewSuperior
DN getNewSuperior()
Retrieves the newSuperior DN for the entry. This should not be called by pre-parse plugins, because the processed DN will not yet be available at that time. Instead, they should use thegetRawNewSuperiormethod.- Specified by:
getNewSuperiorin interfaceSubordinateModifyDNOperation- Returns:
- The newSuperior DN for the entry, or
nullif there is no newSuperior DN for this request or if the raw newSuperior has not yet been processed.
-
getNewDN
DN getNewDN()
Retrieves the new DN for the entry.- Returns:
- The new DN for the entry, or
nullif there is neither newRDN, nor entryDN for this request.
-
getModifications
List<Modification> getModifications()
Retrieves the set of modifications applied to attributes of the target entry in the course of processing this modify DN operation. This will include attribute-level changes from the modify DN itself (e.g., removing old RDN values if deleteOldRDN is set, or adding new RDN values that don't already exist), but it may also be used by pre-operation plugins to cause additional changes in the entry. In this case, those plugins may add modifications to this list (they may not remove existing modifications) if any changes should be processed in addition to the core modify DN processing. Backends may read this list to identify which attribute-level changes were applied in order to more easily apply updates to attribute indexes.- Returns:
- The set of modifications applied to attributes during the course
of the modify DN processing, or
nullif that information is not yet available (e.g., during pre-parse plugins).
-
addModification
void addModification(Modification modification)
Adds the provided modification to the set of modifications to be applied as part of the update. This should only be called by pre-operation plugins.- Parameters:
modification- The modification to add to the set of modifications to apply to the entry.
-
getOriginalEntry
Entry getOriginalEntry()
Retrieves the current entry, before it is renamed. This will not be available to pre-parse plugins or during the conflict resolution portion of the synchronization processing.- Specified by:
getOriginalEntryin interfaceSubordinateModifyDNOperation- Returns:
- The current entry, or
nullif it is not yet available.
-
getUpdatedEntry
Entry getUpdatedEntry()
Retrieves the new entry, as it will appear after it is renamed. This will not be available to pre-parse plugins or during the conflict resolution portion of the synchronization processing.- Specified by:
getUpdatedEntryin interfaceSubordinateModifyDNOperation- Returns:
- The updated entry, or
nullif it is not yet available.
-
getProxiedAuthorizationDN
DN getProxiedAuthorizationDN()
Retrieves the proxied authorization DN for this operation if proxied authorization has been requested.- Specified by:
getProxiedAuthorizationDNin interfaceOperation- Returns:
- The proxied authorization DN for this operation if proxied
authorization has been requested, or
nullif proxied authorization has not been requested.
-
setProxiedAuthorizationDN
void setProxiedAuthorizationDN(DN dn)
Sets the proxied authorization DN for this operation if proxied authorization has been requested.- Specified by:
setProxiedAuthorizationDNin interfaceOperation- Parameters:
dn- The proxied authorization DN for this operation if proxied authorization has been requested, ornullif proxied authorization has not been requested.
-
-