Package org.opends.server.core
Class AddOperation
- java.lang.Object
-
- org.opends.server.types.Operation
-
- org.opends.server.core.AddOperation
-
- All Implemented Interfaces:
Runnable
,PluginOperation
,PostOperationAddOperation
,PostOperationOperation
,PostResponseAddOperation
,PostResponseOperation
,PostSynchronizationAddOperation
,PostSynchronizationOperation
,PreOperationAddOperation
,PreOperationOperation
,PreParseAddOperation
,PreParseOperation
public final class AddOperation extends Operation implements PreParseAddOperation, PreOperationAddOperation, PostOperationAddOperation, PostResponseAddOperation, PostSynchronizationAddOperation
This class defines an operation that may be used to add a new entry to the Directory Server.
-
-
Field Summary
-
Fields inherited from class org.opends.server.types.Operation
requestContext
-
-
Constructor Summary
Constructors Constructor Description AddOperation(org.forgerock.services.context.Context context, AddRequest request)
Creates a new add operation with the provided information.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
addAttribute(Attribute attribute)
Adds the provided attribute to the set of attributes for this add operation.void
addObjectClass(ObjectClass objectClass, String name)
Adds the provided objectclass to the entry to add.void
addResponseControl(Control control)
Adds the provided control to the set of controls to include in the response to the client.Iterable<Attribute>
getAllAttributes()
Retrieves the set of attributes as read from the client request.Dn
getEntryDN()
Retrieves the DN of the entry to add.Entry
getEntryToAdd()
Retrieves the entry to be added to the server.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
removeAttribute(AttributeType attributeType)
Removes the specified attribute from the entry to add.void
removeObjectClass(ObjectClass objectClass)
Removes the provided objectclass from the entry to add.void
removeResponseControl(Control control)
Removes the provided control from the set of controls to include in the response to the client.void
replaceAttribute(Attribute attribute)
Adds all of the attribute values contained inattribute
to this entry, replacing any existing attribute values (optional operation).void
run()
Performs the work of actually processing this operation.void
setEntryDN(Dn entryDN)
Specifies the entry DN for the entry to add.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
-
AddOperation
public AddOperation(org.forgerock.services.context.Context context, AddRequest request)
Creates a new add operation with the provided information.- Parameters:
context
- The context with which this operation is associated.request
- The add request.
-
-
Method Detail
-
setEntryDN
public void setEntryDN(Dn entryDN)
Description copied from interface:PreParseAddOperation
Specifies the entry DN for the entry to add.- Specified by:
setEntryDN
in interfacePreParseAddOperation
- Parameters:
entryDN
- The entry DN for the entry to add.
-
getEntryDN
public Dn getEntryDN()
Description copied from interface:PreParseAddOperation
Retrieves the DN of the entry to add.- Specified by:
getEntryDN
in interfacePostOperationAddOperation
- Specified by:
getEntryDN
in interfacePostResponseAddOperation
- Specified by:
getEntryDN
in interfacePostSynchronizationAddOperation
- Specified by:
getEntryDN
in interfacePreOperationAddOperation
- Specified by:
getEntryDN
in interfacePreParseAddOperation
- Returns:
- The DN of the entry to add.
-
addAttribute
public void addAttribute(Attribute attribute)
Description copied from interface:PreParseAddOperation
Adds the provided attribute to the set of attributes for this add operation.- Specified by:
addAttribute
in interfacePreParseAddOperation
- Parameters:
attribute
- The attribute to add to the set of attributes for this add operation.
-
addObjectClass
public void addObjectClass(ObjectClass objectClass, String name)
Adds the provided objectclass to the entry to add. This should only be called from pre-operation plugins. Note that pre-operation plugin processing is invoked after access control and schema validation, so plugins should be careful to only make changes that will not violate either schema or access control rules.- Specified by:
addObjectClass
in interfacePreOperationAddOperation
- Parameters:
objectClass
- The objectclass to add to the entry.name
- The name to use for the objectclass.
-
removeObjectClass
public void removeObjectClass(ObjectClass objectClass)
Removes the provided objectclass from the entry to add. This should only be called from pre-operation plugins. Note that pre-operation plugin processing is invoked after access control and schema validation, so plugins should be careful to only make changes that will not violate either schema or access control rules.- Specified by:
removeObjectClass
in interfacePreOperationAddOperation
- Parameters:
objectClass
- The objectclass to remove from the entry.
-
getAllAttributes
public Iterable<Attribute> getAllAttributes()
Description copied from interface:PreParseAddOperation
Retrieves the set of attributes as read from the client request. Some of these attributes may be invalid as no validation will have been performed on them.- Specified by:
getAllAttributes
in interfacePostOperationAddOperation
- Specified by:
getAllAttributes
in interfacePostResponseAddOperation
- Specified by:
getAllAttributes
in interfacePostSynchronizationAddOperation
- Specified by:
getAllAttributes
in interfacePreOperationAddOperation
- Specified by:
getAllAttributes
in interfacePreParseAddOperation
- Returns:
- The set of attributes as read from the client request.
-
replaceAttribute
public void replaceAttribute(Attribute attribute)
Description copied from interface:PreOperationAddOperation
Adds all of the attribute values contained inattribute
to this entry, replacing any existing attribute values (optional operation). Ifattribute
is empty then the entire attribute will be removed if it is present.NOTE: This method implements LDAP Modify replace semantics as described in RFC 4511 - Section 4.6. Modify Operation.
- Specified by:
replaceAttribute
in interfacePreOperationAddOperation
- Parameters:
attribute
- The attribute values to be added to this entry, replacing any existing attribute values, and which may be empty if the entire attribute is to be removed.
-
removeAttribute
public void removeAttribute(AttributeType attributeType)
Removes the specified attribute from the entry to add. This should only be called from pre-operation plugins. Note that pre-operation processing is invoked after access control and schema validation, so plugins should be careful to only make changes that will not violate either schema or access control rules.- Specified by:
removeAttribute
in interfacePreOperationAddOperation
- Parameters:
attributeType
- The attribute type for the attribute to remove.
-
getOperationType
public OperationType getOperationType()
Description copied from interface:PluginOperation
Retrieves the operation type for this operation.- Specified by:
getOperationType
in interfacePluginOperation
- 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 classOperation
- 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 interfacePluginOperation
- 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 interfacePostOperationOperation
- Specified by:
addResponseControl
in interfacePreOperationOperation
- Specified by:
addResponseControl
in interfacePreParseOperation
- Specified by:
addResponseControl
in classOperation
- 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 interfacePostOperationOperation
- Specified by:
removeResponseControl
in interfacePreOperationOperation
- Specified by:
removeResponseControl
in interfacePreParseOperation
- Specified by:
removeResponseControl
in classOperation
- 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 interfacePluginOperation
- Specified by:
toString
in classOperation
- 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 classOperation
- Parameters:
proxiedAuthorizationDN
- The proxied authorization DN for this operation if proxied authorization has been requested, ornull
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.
-
getEntryToAdd
public Entry getEntryToAdd()
Retrieves the entry to be added to the server. Note that this will not be available to pre-parse plugins or during the conflict resolution portion of the synchronization processing.- Specified by:
getEntryToAdd
in interfacePostOperationAddOperation
- Specified by:
getEntryToAdd
in interfacePostResponseAddOperation
- Specified by:
getEntryToAdd
in interfacePostSynchronizationAddOperation
- Specified by:
getEntryToAdd
in interfacePreOperationAddOperation
- Returns:
- The entry to be added to the server, or
null
if it is not yet available.
-
-