org.opencms.workflow

类 CmsExtendedWorkflowManager

java.lang.Object

org.opencms.workflow.A_CmsWorkflowManager

org.opencms.workflow.CmsDefaultWorkflowManager

org.opencms.workflow.CmsExtendedWorkflowManager

所有已实现的接口:

I_CmsWorkflowManager

public class CmsExtendedWorkflowManager
extends CmsDefaultWorkflowManager

The default workflow manager implementation, which supports 2 basic actions, Release and Publish.

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	ACTION_RELEASE The release workflow action.
static java.lang.String	PARAM_NOTIFICATION_CONTENT The parameter which points to the XML content used for notifications.
static java.lang.String	PARAM_WORKFLOW_PROJECT_MANAGER_GROUP The key for the configurable workflow project manager group.
static java.lang.String	PARAM_WORKFLOW_PROJECT_USER_GROUP The key for the configurable workflow project user group.
static java.lang.String	WORKFLOW_RELEASE The key for the 'release' workflow.

从类继承的字段 org.opencms.workflow.CmsDefaultWorkflowManager

ACTION_FORCE_PUBLISH, ACTION_PUBLISH, DEFAULT_RESOURCE_LIMIT, m_virtualProjects, PARAM_RESOURCE_LIMIT, WORKFLOW_PUBLISH

从类继承的字段 org.opencms.workflow.A_CmsWorkflowManager

m_adminCms, m_parameters

构造器概要

构造器

构造器和说明
CmsExtendedWorkflowManager()

方法概要

方法

限定符和类型	方法和说明
protected CmsWorkflowResponse	actionRelease(CmsObject userCms, java.util.List<CmsResource> resources) Implementation of the 'release' workflow action.
protected void	checkNewParentsInList(CmsObject userCms, java.util.List<CmsResource> resources) Checks that the parent folders of new resources which are released are either not new or are also released.
protected void	cleanupEmptyWorkflowProjects(java.util.List<CmsProject> projects) Cleans up empty workflow projects.
protected void	cleanupProjectIfEmpty(CmsProject project) Removes a project if there are no longer any resources which have been last modified in that project.
protected void	clearLocks(CmsProject project, java.util.List<CmsResource> resources) Ensures that the resources to be released are unlocked.
I_CmsPublishResourceFormatter	createFormatter(CmsObject cms, CmsWorkflow workflow, CmsPublishOptions options) Creates the formatter for formatting the resources to be displayed to the user.
CmsWorkflowResponse	executeAction(CmsObject userCms, CmsWorkflowAction action, CmsPublishOptions options, java.util.List<CmsResource> resources) Executes a workflow action in the context of the current user.
protected boolean	existsProject(java.lang.String projectName) Helper method to check whether a project exists.
protected java.lang.String	generateProjectDescription(CmsObject userCms) Generates the description for a new workflow project based on the user for whom it is created.
protected java.lang.String	generateProjectName(CmsObject userCms) Generates the name for a new workflow project based on the user for whom it is created.
protected java.lang.String	generateProjectName(CmsObject userCms, boolean shortTime) Generates the name for a new workflow project based on the user for whom it is created.
protected java.util.List<CmsUser>	getNotificationMailRecipients() Gets the list of recipients for the notifications.
protected java.lang.String	getNotificationResource() Gets the resource notification content path.
protected CmsWorkflowResponse	getPublishBrokenRelationsResponse(CmsObject userCms, java.util.List<CmsPublishResource> publishResources) Helper method for generating the workflow response which should be sent when publishing the resources would break relations.
I_CmsVirtualProject	getRealOrVirtualProject(CmsUUID projectId) Gets the virtual project object identified by the given id.
protected CmsWorkflowResponse	getSuccessResponse() Gets the workflow response which should be sent when the resources have successfully been published.
java.lang.String	getWorkflowProjectManagerGroup() Gets the name of the group which should be used as the 'manager' group for newly created workflow projects.
java.lang.String	getWorkflowProjectUserGroup() Gets the name of the group which should be used as the 'user' group for newly created workflow projects.
java.util.Map<java.lang.String,CmsWorkflow>	getWorkflows(CmsObject cms) Returns the available workflows for the current user.
void	initialize(CmsObject adminCms) Initializes this workflow manager instance.
protected boolean	isProjectEmpty(CmsProject project) Checks whether there are resources which have last been modified in a given project.
protected boolean	isProjectManager(CmsObject userCms) Checks whether the user for a given CMS context can manage workflow projects.
protected void	onFinishPublishJob(CmsPublishJobRunning publishJob) Handles finished publish jobs by removing projects of resources in the publish job if they are empty workflow projects.
protected void	onStartPublishJob(CmsPublishJobEnqueued publishJob) This is called when a publish job is started.
protected void	sendNotification(CmsObject userCms, CmsUser recipient, CmsProject workflowProject, java.util.List<CmsResource> resources) Sends the notification for released resources.

从类继承的方法 org.opencms.workflow.CmsDefaultWorkflowManager

actionForcePublish, actionPublish, createProjectBeanFromProject, executeAction, getLabel, getManageableProjects, getOuAwareName, getPublishListToken, getResourceLimit, getWorkflowResources

从类继承的方法 org.opencms.workflow.A_CmsWorkflowManager

getLocale, getParameter, getParameters, setParameters

从类继承的方法 java.lang.Object

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

字段详细资料

ACTION_RELEASE

public static final java.lang.String ACTION_RELEASE

The release workflow action.

另请参阅:

常量字段值

PARAM_NOTIFICATION_CONTENT

public static final java.lang.String PARAM_NOTIFICATION_CONTENT

The parameter which points to the XML content used for notifications.

另请参阅:

常量字段值

PARAM_WORKFLOW_PROJECT_MANAGER_GROUP

public static final java.lang.String PARAM_WORKFLOW_PROJECT_MANAGER_GROUP

The key for the configurable workflow project manager group.

另请参阅:

常量字段值

PARAM_WORKFLOW_PROJECT_USER_GROUP

public static final java.lang.String PARAM_WORKFLOW_PROJECT_USER_GROUP

The key for the configurable workflow project user group.

另请参阅:

常量字段值

WORKFLOW_RELEASE

public static final java.lang.String WORKFLOW_RELEASE

The key for the 'release' workflow.

另请参阅:

常量字段值

构造器详细资料

CmsExtendedWorkflowManager

public CmsExtendedWorkflowManager()

方法详细资料

createFormatter

public I_CmsPublishResourceFormatter createFormatter(CmsObject cms,
                                            CmsWorkflow workflow,
                                            CmsPublishOptions options)

从接口复制的说明: I_CmsWorkflowManager

Creates the formatter for formatting the resources to be displayed to the user.

指定者:

createFormatter 在接口中 I_CmsWorkflowManager

覆盖:

createFormatter 在类中 CmsDefaultWorkflowManager

参数:

cms - the CMS context to use

workflow - the current workflow

options - the publish options

返回:

the publish resource formatter to use

另请参阅:

CmsDefaultWorkflowManager.createFormatter(org.opencms.file.CmsObject, org.opencms.ade.publish.shared.CmsWorkflow, org.opencms.ade.publish.shared.CmsPublishOptions)

executeAction

public CmsWorkflowResponse executeAction(CmsObject userCms,
                                CmsWorkflowAction action,
                                CmsPublishOptions options,
                                java.util.List<CmsResource> resources)
                                  throws CmsException

从接口复制的说明: I_CmsWorkflowManager

Executes a workflow action in the context of the current user.

指定者:

executeAction 在接口中 I_CmsWorkflowManager

覆盖:

executeAction 在类中 CmsDefaultWorkflowManager

参数:

userCms - the current user's CMS context

action - the workflow action

options - the publish options

resources - the resources to be processed

返回:

the workflow response for the executed action

抛出:

CmsException - if something goes wrong

另请参阅:

CmsDefaultWorkflowManager.executeAction(org.opencms.file.CmsObject, org.opencms.ade.publish.shared.CmsWorkflowAction, org.opencms.ade.publish.shared.CmsPublishOptions, java.util.List)

getRealOrVirtualProject

public I_CmsVirtualProject getRealOrVirtualProject(CmsUUID projectId)

从接口复制的说明: I_CmsWorkflowManager

Gets the virtual project object identified by the given id.

指定者:

getRealOrVirtualProject 在接口中 I_CmsWorkflowManager

覆盖:

getRealOrVirtualProject 在类中 CmsDefaultWorkflowManager

参数:

projectId - the virtual project id

返回:

the virtual project object

另请参阅:

CmsDefaultWorkflowManager.getRealOrVirtualProject(org.opencms.util.CmsUUID)

getWorkflowProjectManagerGroup

public java.lang.String getWorkflowProjectManagerGroup()

Gets the name of the group which should be used as the 'manager' group for newly created workflow projects.

返回:

a group name

getWorkflowProjectUserGroup

public java.lang.String getWorkflowProjectUserGroup()

Gets the name of the group which should be used as the 'user' group for newly created workflow projects.

返回:

a group name

getWorkflows

public java.util.Map<java.lang.String,CmsWorkflow> getWorkflows(CmsObject cms)

从接口复制的说明: I_CmsWorkflowManager

Returns the available workflows for the current user.

指定者:

getWorkflows 在接口中 I_CmsWorkflowManager

覆盖:

getWorkflows 在类中 CmsDefaultWorkflowManager

参数:

cms - the user cms context

返回:

the available workflows

另请参阅:

I_CmsWorkflowManager.getWorkflows(org.opencms.file.CmsObject)

initialize

public void initialize(CmsObject adminCms)

从接口复制的说明: I_CmsWorkflowManager

Initializes this workflow manager instance.

指定者:

initialize 在接口中 I_CmsWorkflowManager

覆盖:

initialize 在类中 CmsDefaultWorkflowManager

参数:

adminCms - the CMS context with admin privileges

另请参阅:

A_CmsWorkflowManager.initialize(org.opencms.file.CmsObject)

actionRelease

protected CmsWorkflowResponse actionRelease(CmsObject userCms,
                                java.util.List<CmsResource> resources)
                                     throws CmsException

Implementation of the 'release' workflow action.

参数:

userCms - the current user's CMS context

resources - the resources which should be released

返回:

the workflow response for this action

抛出:

CmsException - if something goes wrong

checkNewParentsInList

protected void checkNewParentsInList(CmsObject userCms,
                         java.util.List<CmsResource> resources)
                              throws CmsException

Checks that the parent folders of new resources which are released are either not new or are also released.

参数:

userCms - the user CMS context

resources - the resources to check

抛出:

CmsException - if the check fails

cleanupEmptyWorkflowProjects

protected void cleanupEmptyWorkflowProjects(java.util.List<CmsProject> projects)
                                     throws CmsException

Cleans up empty workflow projects.

参数:

projects - the workflow projects to clean up

抛出:

CmsException - if something goes wrong

cleanupProjectIfEmpty

protected void cleanupProjectIfEmpty(CmsProject project)
                              throws CmsException

Removes a project if there are no longer any resources which have been last modified in that project.

参数:

project - the project

抛出:

CmsException

clearLocks

protected void clearLocks(CmsProject project,
              java.util.List<CmsResource> resources)
                   throws CmsException

Ensures that the resources to be released are unlocked.

参数:

project - the project in which to operate

resources - the resources for which the locks should be removed

抛出:

CmsException - if something goes wrong

existsProject

protected boolean existsProject(java.lang.String projectName)

Helper method to check whether a project exists.

参数:

projectName - the project name

返回:

true if the project exists

generateProjectDescription

protected java.lang.String generateProjectDescription(CmsObject userCms)

Generates the description for a new workflow project based on the user for whom it is created.

参数:

userCms - the user's current CMS context

返回:

the workflow project description

generateProjectName

protected java.lang.String generateProjectName(CmsObject userCms)

Generates the name for a new workflow project based on the user for whom it is created.

参数:

userCms - the user's current CMS context

返回:

the workflow project name

generateProjectName

protected java.lang.String generateProjectName(CmsObject userCms,
                                   boolean shortTime)

Generates the name for a new workflow project based on the user for whom it is created.

参数:

userCms - the user's current CMS context

shortTime - if true, the short time format will be used, else the medium time format

返回:

the workflow project name

getNotificationMailRecipients

protected java.util.List<CmsUser> getNotificationMailRecipients()

Gets the list of recipients for the notifications.

返回:

the list of users which should be notified when resources are released

getNotificationResource

protected java.lang.String getNotificationResource()

Gets the resource notification content path.

返回:

the resource notification content path

getPublishBrokenRelationsResponse

protected CmsWorkflowResponse getPublishBrokenRelationsResponse(CmsObject userCms,
                                                    java.util.List<CmsPublishResource> publishResources)

Helper method for generating the workflow response which should be sent when publishing the resources would break relations.

参数:

userCms - the user's CMS context

publishResources - the resources whose links would be broken

返回:

the workflow response

getSuccessResponse

protected CmsWorkflowResponse getSuccessResponse()

Gets the workflow response which should be sent when the resources have successfully been published.

返回:

the successful workflow response

isProjectEmpty

protected boolean isProjectEmpty(CmsProject project)
                          throws CmsException

Checks whether there are resources which have last been modified in a given project.

参数:

project - the project which should be checked

返回:

true if there are no resources which have been last modified inside the project

抛出:

CmsException - if something goes wrong

isProjectManager

protected boolean isProjectManager(CmsObject userCms)
                            throws CmsException

Checks whether the user for a given CMS context can manage workflow projects.

参数:

userCms - the user CMS Context

返回:

true if this user can manage workflow projects

抛出:

CmsException - if something goes wrong

onFinishPublishJob

protected void onFinishPublishJob(CmsPublishJobRunning publishJob)

Handles finished publish jobs by removing projects of resources in the publish job if they are empty workflow projects.

参数:

publishJob - the finished published job

onStartPublishJob

protected void onStartPublishJob(CmsPublishJobEnqueued publishJob)

This is called when a publish job is started.

参数:

publishJob - the publish job being started

sendNotification

protected void sendNotification(CmsObject userCms,
                    CmsUser recipient,
                    CmsProject workflowProject,
                    java.util.List<CmsResource> resources)

Sends the notification for released resources.

参数:

userCms - the user's CMS context

recipient - the OpenCms user to whom the notification should be sent

workflowProject - the workflow project which

resources - the resources which have been affected by a workflow action