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

NO_RESPONSE_CONTROLS, requestContext

Constructor Summary

Constructors

Constructor and Description
AddOperation(org.forgerock.services.context.Context context, AddRequest request) Creates a new add operation with the provided information.

Method Summary

Modifier and Type	Method and 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.
Entry	getEntry() Returns the entry to add.
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 in attribute 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.
void	updateOperationErrMsgAndResCode() Updates the error message and the result code of the operation.

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

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

Methods inherited from class java.lang.Object

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

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

addAdditionalLogItem, addRequestControl, appendErrorMessage, getAdditionalLogItems, getErrorMessage, setErrorMessage

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

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

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

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

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

checkIfCanceled, disconnectClient, getAttachment, getAttachments, getClientConnection, getConnectionID, getMessageID, getOperationID, getProcessingStartTime, getRequestControl, getRequestControl, getRequestControls, isInternalOperation, isSynchronizationOperation, removeAttachment, setAttachment, toString

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 interface PreParseAddOperation

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 interface PostOperationAddOperation

Specified by:

getEntryDN in interface PostResponseAddOperation

Specified by:

getEntryDN in interface PostSynchronizationAddOperation

Specified by:

getEntryDN in interface PreOperationAddOperation

Specified by:

getEntryDN in interface PreParseAddOperation

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 interface PreParseAddOperation

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 interface PreOperationAddOperation

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 interface PreOperationAddOperation

Parameters:

objectClass - The objectclass to remove from the entry.

getEntry

public Entry getEntry()

Description copied from interface: PreOperationAddOperation

Returns the entry to add.

Specified by:

getEntry in interface PostOperationAddOperation

Specified by:

getEntry in interface PostResponseAddOperation

Specified by:

getEntry in interface PostSynchronizationAddOperation

Specified by:

getEntry in interface PreOperationAddOperation

Returns:

the entry to add

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 interface PostOperationAddOperation

Specified by:

getAllAttributes in interface PostResponseAddOperation

Specified by:

getAllAttributes in interface PostSynchronizationAddOperation

Specified by:

getAllAttributes in interface PreOperationAddOperation

Specified by:

getAllAttributes in interface PreParseAddOperation

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 in attribute to this entry, replacing any existing attribute values (optional operation). If attribute 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 interface PreOperationAddOperation

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 interface PreOperationAddOperation

Parameters:

attributeType - The attribute tyep 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 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 class: Operation

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

updateOperationErrMsgAndResCode

public void updateOperationErrMsgAndResCode()

Description copied from class: Operation

Updates the error message and the result code of the operation. This method is called because the operation could not be routed to any local backends.

Overrides:

updateOperationErrMsgAndResCode in class Operation

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 interface PostOperationAddOperation

Specified by:

getEntryToAdd in interface PostResponseAddOperation

Specified by:

getEntryToAdd in interface PostSynchronizationAddOperation

Specified by:

getEntryToAdd in interface PreOperationAddOperation

Returns:

The entry to be added to the server, or null if it is not yet available.