org.ametys.cms.workflow

Class CreateContentFunction

java.lang.Object

org.ametys.plugins.workflow.AbstractWorkflowComponent

org.ametys.cms.workflow.AbstractContentWorkflowComponent

org.ametys.cms.workflow.CreateContentFunction

All Implemented Interfaces:

com.opensymphony.workflow.FunctionProvider, LogEnabled, Serviceable

Direct Known Subclasses:

CreateContentByCopyFunction, CreateContentFunction, CreateSimpleContentFunction, CreateSynchronizedContentFunction

public class CreateContentFunction
extends AbstractContentWorkflowComponent
implements com.opensymphony.workflow.FunctionProvider

OSWorkflow function for creating a content.

Field Summary

Fields

Modifier and Type	Field and Description
protected ObservationManager	_observationManager Observation manager available to subclasses.
protected AmetysObjectResolver	_resolver Ametys object resolver available to subclasses.
static String	CONTENT_LANGUAGE_KEY Constant for storing the content language to use into the transient variables map.
static String	CONTENT_MIXINS_KEY Constant for storing the content type to use into the transient variables map.
static String	CONTENT_NAME_KEY Constant for storing the content name to use into the transient variables map.
static String	CONTENT_TITLE_KEY Constant for storing the content title to use into the transient variables map.
static String	CONTENT_TYPES_KEY Constant for storing the content type to use into the transient variables map.
static String	PARENT_CONTENT_ID_KEY Constant for storing the content language to use into the transient variables map.
static String	PARENT_CONTENT_METADATA_PATH_KEY Constant for storing the content language to use into the transient variables map.

Fields inherited from class org.ametys.cms.workflow.AbstractContentWorkflowComponent

CONTENT_KEY

Fields inherited from class org.ametys.plugins.workflow.AbstractWorkflowComponent

_logger, _manager, CONTEXT_PARAMETERS_KEY, FAIL_CONDITIONS_KEY, RESULT_MAP_KEY, WORKFLOW_ERRORS_KEY, WORKFLOW_WARNS_KEY

Constructor Summary

Constructors

Constructor and Description
CreateContentFunction()

Method Summary

Modifier and Type	Method and Description
protected ModifiableWorkflowAwareContent	_createContent(Map transientVars, String desiredContentName, ModifiableTraversableAmetysObject contentsNode) Create the content object.
protected ModifiableTraversableAmetysObject	_getContentRoot(Map transientVars) Retrieve the content root.
protected String	_getNonNullVar(Map transientVars, String name, String exceptionName) Get a workflow parameter, throwing an exception if it is null.
protected String	_getObjectType(Map transientVars) Return the type of the object to be created.
protected ModifiableTraversableAmetysObject	_getSubContentRoot(String parentContentId, String parentContentMetadataPath) Get the content root when creating a sub-content.
protected List<Future>	_notifyContentAdded(Content content, Map transientVars) Notify observers that the content has been created
protected void	_populateAdditionalData(Map transientVars, ModifiableContent content) Populate the content.
protected void	_populateContent(Map transientVars, ModifiableContent content) Populate the content.
void	execute(Map transientVars, Map args, com.opensymphony.module.propertyset.PropertySet ps)
protected UserIdentity	getSystemUser() Get the user to use when the content is created in a background environment.
void	service(ServiceManager manager)

Methods inherited from class org.ametys.cms.workflow.AbstractContentWorkflowComponent

getContent

Methods inherited from class org.ametys.plugins.workflow.AbstractWorkflowComponent

addWorkflowError, addWorkflowWarning, enableLogging, getConditionFailures, getContextParameters, getResultsMap, getUser

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

CONTENT_NAME_KEY

public static final String CONTENT_NAME_KEY

Constant for storing the content name to use into the transient variables map.

CONTENT_TITLE_KEY

public static final String CONTENT_TITLE_KEY

Constant for storing the content title to use into the transient variables map.

CONTENT_TYPES_KEY

public static final String CONTENT_TYPES_KEY

Constant for storing the content type to use into the transient variables map.

CONTENT_MIXINS_KEY

public static final String CONTENT_MIXINS_KEY

Constant for storing the content type to use into the transient variables map.

CONTENT_LANGUAGE_KEY

public static final String CONTENT_LANGUAGE_KEY

Constant for storing the content language to use into the transient variables map.

PARENT_CONTENT_ID_KEY

public static final String PARENT_CONTENT_ID_KEY

Constant for storing the content language to use into the transient variables map.

PARENT_CONTENT_METADATA_PATH_KEY

public static final String PARENT_CONTENT_METADATA_PATH_KEY

Constant for storing the content language to use into the transient variables map.

_resolver

protected AmetysObjectResolver _resolver

Ametys object resolver available to subclasses.

_observationManager

protected ObservationManager _observationManager

Observation manager available to subclasses.

Constructor Detail

CreateContentFunction

public CreateContentFunction()

Method Detail

service

public void service(ServiceManager manager)
             throws ServiceException

Specified by:

service in interface Serviceable

Overrides:

service in class AbstractWorkflowComponent

Throws:

ServiceException

execute

public void execute(Map transientVars,
                    Map args,
                    com.opensymphony.module.propertyset.PropertySet ps)
             throws com.opensymphony.workflow.WorkflowException

Specified by:

execute in interface com.opensymphony.workflow.FunctionProvider

Throws:

com.opensymphony.workflow.WorkflowException

_notifyContentAdded

protected List<Future> _notifyContentAdded(Content content,
                                           Map transientVars)
                                    throws com.opensymphony.workflow.WorkflowException

Notify observers that the content has been created

Parameters:

content - The content added

transientVars - The workflow vars

Returns:

The Future objects of the asynchronous observers

Throws:

com.opensymphony.workflow.WorkflowException - If an error occurred

_createContent

protected ModifiableWorkflowAwareContent _createContent(Map transientVars,
                                                        String desiredContentName,
                                                        ModifiableTraversableAmetysObject contentsNode)

Create the content object.

Parameters:

transientVars - the workflow parameters.

desiredContentName - the desired content name.

contentsNode - the content root node in the repository.

Returns:

the created Content.

_getObjectType

protected String _getObjectType(Map transientVars)

Return the type of the object to be created. Ex: ametys:defaultContent.

Parameters:

transientVars - The workflow vars

Returns:

The type of the object to be used during content creation.

_getContentRoot

protected ModifiableTraversableAmetysObject _getContentRoot(Map transientVars)
                                                     throws com.opensymphony.workflow.WorkflowException

Retrieve the content root.

Parameters:

transientVars - the workflow parameters.

Returns:

the content root node.

Throws:

com.opensymphony.workflow.WorkflowException - if an error occurs

_getSubContentRoot

protected ModifiableTraversableAmetysObject _getSubContentRoot(String parentContentId,
                                                               String parentContentMetadataPath)
                                                        throws com.opensymphony.workflow.WorkflowException

Get the content root when creating a sub-content.

Parameters:

parentContentId - the parent content ID.

parentContentMetadataPath - the path of the metadata in which to create the sub-content.

Returns:

the content collection metadata.

Throws:

com.opensymphony.workflow.WorkflowException - if an error occurs.

_getNonNullVar

protected String _getNonNullVar(Map transientVars,
                                String name,
                                String exceptionName)
                         throws com.opensymphony.workflow.WorkflowException

Get a workflow parameter, throwing an exception if it is null.

Parameters:

transientVars - the workflow parameters.

name - the variable name.

exceptionName - label of the exception to throw if the variable is null.

Returns:

the variable value.

Throws:

com.opensymphony.workflow.WorkflowException - If an error occurred

_populateContent

protected void _populateContent(Map transientVars,
                                ModifiableContent content)
                         throws com.opensymphony.workflow.WorkflowException

Populate the content.

Parameters:

transientVars - the transient variables.

content - the content.

Throws:

com.opensymphony.workflow.WorkflowException - if an error occurs.

getSystemUser

protected UserIdentity getSystemUser()

Get the user to use when the content is created in a background environment.

Returns:

The anonymous user

_populateAdditionalData

protected void _populateAdditionalData(Map transientVars,
                                       ModifiableContent content)
                                throws com.opensymphony.workflow.WorkflowException

Populate the content.

Parameters:

transientVars - the transient variables.

content - the content.

Throws:

com.opensymphony.workflow.WorkflowException - if an error occurs.