com.atlassian.jira.workflow
Class OSWorkflowManager

java.lang.Object
  com.atlassian.jira.workflow.SimpleWorkflowManager
      com.atlassian.jira.workflow.OSWorkflowManager

All Implemented Interfaces:

WorkflowManager

public class OSWorkflowManager
extends SimpleWorkflowManager

Constructor Summary

OSWorkflowManager(com.opensymphony.workflow.config.Configuration configuration, DraftWorkflowStore draftWorkflowStore)

OSWorkflowManager(DraftWorkflowStore draftWorkflowStore)

Method Summary

void	copyAndDeleteDraftWorkflows(User user, Set workflows) Provided a set of workflows, this method will check, if the passed in workflows have any draft workflows linked to them.
JiraWorkflow	copyWorkflow(String username, String clonedWorkflowName, String clonedWorkflowDescription, JiraWorkflow workflowToClone) Clones a workflow by creating a deep copy of the workflow provided.
JiraWorkflow	createDraftWorkflow(String username, String parentWorkflowName) This will create an draft workflow of the named active workflow.
void	createWorkflow(String username, JiraWorkflow workflow)
void	createWorkflow(User creator, JiraWorkflow workflow)
boolean	deleteDraftWorkflow(String parentWorkflowName) Deletes all draft workflows (there should every be only one) for a given parent workflow.
void	deleteWorkflow(JiraWorkflow workflow)
Collection	getActiveWorkflows() Retrieve all currently active workflows.
JiraWorkflow	getDraftWorkflow(String parentWorkflowName) Retrieve a single draft workflow by name.
JiraWorkflow	getWorkflow(org.ofbiz.core.entity.GenericValue issue) Retrieve the workflow for a given issue.
JiraWorkflow	getWorkflow(Issue issue) Retrieve the workflow for a given issue.
JiraWorkflow	getWorkflow(Long projectId, String issueTypeId) Retrieve the workflow for a given project - issue type pair.
JiraWorkflow	getWorkflow(String name) Retrieve a single workflow by name.
JiraWorkflow	getWorkflowClone(String name) This method returns a JiraWorkflow, that contains a WorkflowDescriptor that is mutable.
JiraWorkflow	getWorkflowFromScheme(org.ofbiz.core.entity.GenericValue scheme, String issueTypeId) Return the workflow in a particular scheme for a given issue type.
protected String	getWorkflowName(Long projectId, String issueType) This method returns the (unique) name of the workflow which should be used for the provided projectId and issueType
Collection	getWorkflows() Retrieve all of the workflows in the system
protected WorkflowSchemeManager	getWorkflowSchemeManager()
Collection	getWorkflowsFromScheme(org.ofbiz.core.entity.GenericValue scheme) Returns all workflows for a given scheme
boolean	isActive(JiraWorkflow workflow) Determine whether or not a given workflow is active in the system.
boolean	isSystemWorkflow(JiraWorkflow workflow) Determine whether or not a given workflow is a system workflow.
void	migrateIssueToWorkflow(org.ofbiz.core.entity.GenericValue issue, JiraWorkflow newWorkflow, org.ofbiz.core.entity.GenericValue newStatus)
void	overwriteActiveWorkflow(String username, String workflowName) Saves the draft workflow into the active workflow.
void	saveWorkflowWithoutAudit(JiraWorkflow workflow) This method will save the workflow and it will not affect the updatedDate and updatedAuthorName meta attributes of the workflow.
protected void	updateIssueStatusAndUpdatedDate(org.ofbiz.core.entity.GenericValue issue, org.ofbiz.core.entity.GenericValue newStatus)
void	updateWorkflow(String username, JiraWorkflow workflow) Saves the given JiraWorkflow, which may be either a "live" or "draft" version.
void	updateWorkflowNameAndDescription(String username, JiraWorkflow currentWorkflow, String newName, String newDescription) Used to change the name and description of an existing worfklow with the given name.
boolean	workflowExists(String name)

Methods inherited from class com.atlassian.jira.workflow.SimpleWorkflowManager

createIssue, doWorkflowAction, getActionDescriptor, getConfiguration, getDefaultWorkflow, getPostFunctionsForWorkflow, getRemoteUser, getStepId, getStore, isEditable, makeWorkflow, migrateIssueToWorkflow, removeWorkflowEntries, resetConfiguration

Methods inherited from class java.lang.Object

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

Constructor Detail

OSWorkflowManager

public OSWorkflowManager(DraftWorkflowStore draftWorkflowStore)

OSWorkflowManager

public OSWorkflowManager(com.opensymphony.workflow.config.Configuration configuration,
                         DraftWorkflowStore draftWorkflowStore)

Method Detail

getWorkflows

public Collection getWorkflows()

Retrieve all of the workflows in the system

Specified by:

getWorkflows in interface WorkflowManager

Overrides:

getWorkflows in class SimpleWorkflowManager

Returns:

A collection of JiraWorkflow objects.

getWorkflowName

protected String getWorkflowName(Long projectId,
                                 String issueType)
                          throws WorkflowException

This method returns the (unique) name of the workflow which should be used for the provided projectId and issueType

Parameters:

projectId -

issueType -

Returns:

the name of the workflow that should be used for the issue

Throws:

WorkflowException

getActiveWorkflows

public Collection getActiveWorkflows()
                              throws WorkflowException

Description copied from interface: WorkflowManager

Retrieve all currently active workflows.

Specified by:

getActiveWorkflows in interface WorkflowManager

Overrides:

getActiveWorkflows in class SimpleWorkflowManager

Returns:

Collection of JiraWorkflow objects.

Throws:

WorkflowException

isActive

public boolean isActive(JiraWorkflow workflow)
                 throws WorkflowException

Description copied from interface: WorkflowManager

Determine whether or not a given workflow is active in the system.

Active workflows are those currently assigned to schemes and associated with projects - they cannot be edited but can be used.

Specified by:

isActive in interface WorkflowManager

Overrides:

isActive in class SimpleWorkflowManager

Throws:

WorkflowException

isSystemWorkflow

public boolean isSystemWorkflow(JiraWorkflow workflow)

Description copied from interface: WorkflowManager

Determine whether or not a given workflow is a system workflow.

Specified by:

isSystemWorkflow in interface WorkflowManager

Overrides:

isSystemWorkflow in class SimpleWorkflowManager

getWorkflow

public JiraWorkflow getWorkflow(String name)

Description copied from interface: WorkflowManager

Retrieve a single workflow by name. The returned JiraWorkflow contains a descriptor that by default isn't mutable (see ImmutableWorkflowDescriptor

If you need to edit a workflow, please see WorkflowManager.getWorkflowClone(String).

Specified by:

getWorkflow in interface WorkflowManager

Overrides:

getWorkflow in class SimpleWorkflowManager

Parameters:

name - The workflow name

Returns:

A JiraWorkflow that wraps an ImmutableWorkflowDescriptor or null

See Also:

WorkflowManager.getWorkflowClone(String)

getWorkflowClone

public JiraWorkflow getWorkflowClone(String name)

Description copied from interface: WorkflowManager

This method returns a JiraWorkflow, that contains a WorkflowDescriptor that is mutable. This method should be called, if you require to edit the workflow.

If you only need to view a workflow, please use WorkflowManager.getWorkflow(String) as it will provide better performance. Cloning a workflow is expensive, as it requires de-constructing and re-constructing the underlying WorkflowDescriptor from XML.

Specified by:

getWorkflowClone in interface WorkflowManager

Overrides:

getWorkflowClone in class SimpleWorkflowManager

Parameters:

name - The workflow name

Returns:

A JiraWorkflow or null if it doesn't exist.

See Also:

WorkflowManager.getWorkflow(String)

getDraftWorkflow

public JiraWorkflow getDraftWorkflow(String parentWorkflowName)
                              throws IllegalArgumentException

Description copied from interface: WorkflowManager

Retrieve a single draft workflow by name. If there is not an draft workflow associated with the name this will return null.

Specified by:

getDraftWorkflow in interface WorkflowManager

Overrides:

getDraftWorkflow in class SimpleWorkflowManager

Parameters:

parentWorkflowName - is the name of the Saved workflow which identifies then paritally edited draft workflow to retrieve.

Returns:

a JiraWorkflow that represents an draft edited workflow. This is an instance of JiraDraftWorkflow.

Throws:

IllegalArgumentException - if no parentWorkflow with the name provided can be found.

createDraftWorkflow

public JiraWorkflow createDraftWorkflow(String username,
                                        String parentWorkflowName)

Description copied from interface: WorkflowManager

This will create an draft workflow of the named active workflow. This draft workflow can be used to edit active workflows without overwriting the active workflow immediately.
This method will not allow you to create an draft workflow if the parent workflow is not active, the method will throw an IllegalStateException in this case.

Specified by:

createDraftWorkflow in interface WorkflowManager

Overrides:

createDraftWorkflow in class SimpleWorkflowManager

Parameters:

username - identifies the user performing the action so that we can keep an audit trail of who has last saved the workflow. Empty string for anonymous user. If null an IllegalArgumentException will be thrown

parentWorkflowName - identifies the parent workflow that should be used as the template for creating the draft workflow.

Returns:

An instance of JiraDraftWorkflow that represents a copy of the parent that can be edited without overwriting the active workflow immediately.

deleteDraftWorkflow

public boolean deleteDraftWorkflow(String parentWorkflowName)
                            throws IllegalArgumentException

Description copied from interface: WorkflowManager

Deletes all draft workflows (there should every be only one) for a given parent workflow.

Specified by:

deleteDraftWorkflow in interface WorkflowManager

Overrides:

deleteDraftWorkflow in class SimpleWorkflowManager

Parameters:

parentWorkflowName - The parentworkflow for which the draft workflow needs to be deleted.

Returns:

true if a draft workflow as deleted, false otherwise.

Throws:

IllegalArgumentException - if the parentWorkflowName is null

workflowExists

public boolean workflowExists(String name)
                       throws WorkflowException

Specified by:

workflowExists in interface WorkflowManager

Overrides:

workflowExists in class SimpleWorkflowManager

Throws:

WorkflowException

getWorkflow

public JiraWorkflow getWorkflow(Issue issue)
                         throws WorkflowException

Description copied from interface: WorkflowManager

Retrieve the workflow for a given issue.

Specified by:

getWorkflow in interface WorkflowManager

Overrides:

getWorkflow in class SimpleWorkflowManager

Throws:

WorkflowException

getWorkflow

public JiraWorkflow getWorkflow(Long projectId,
                                String issueTypeId)
                         throws WorkflowException

Description copied from interface: WorkflowManager

Retrieve the workflow for a given project - issue type pair.

Specified by:

getWorkflow in interface WorkflowManager

Overrides:

getWorkflow in class SimpleWorkflowManager

Throws:

WorkflowException

getWorkflowFromScheme

public JiraWorkflow getWorkflowFromScheme(org.ofbiz.core.entity.GenericValue scheme,
                                          String issueTypeId)
                                   throws WorkflowException

Description copied from interface: WorkflowManager

Return the workflow in a particular scheme for a given issue type.

Specified by:

getWorkflowFromScheme in interface WorkflowManager

Overrides:

getWorkflowFromScheme in class SimpleWorkflowManager

Throws:

WorkflowException

getWorkflowsFromScheme

public Collection getWorkflowsFromScheme(org.ofbiz.core.entity.GenericValue scheme)
                                  throws WorkflowException

Description copied from interface: WorkflowManager

Returns all workflows for a given scheme

Specified by:

getWorkflowsFromScheme in interface WorkflowManager

Overrides:

getWorkflowsFromScheme in class SimpleWorkflowManager

Returns:

Collection of workflow schemes, empty collection if none exists

Throws:

WorkflowException

copyAndDeleteDraftWorkflows

public void copyAndDeleteDraftWorkflows(User user,
                                        Set workflows)

Description copied from interface: WorkflowManager

Provided a set of workflows, this method will check, if the passed in workflows have any draft workflows linked to them. If they do, it will create an inactive copy of the draft workflow, and delete the draft workflow.

Specified by:

copyAndDeleteDraftWorkflows in interface WorkflowManager

Overrides:

copyAndDeleteDraftWorkflows in class SimpleWorkflowManager

Parameters:

user - The user performing the operation

workflows - A set of parent JiraWorkflows

createWorkflow

public void createWorkflow(String username,
                           JiraWorkflow workflow)
                    throws WorkflowException

Specified by:

createWorkflow in interface WorkflowManager

Overrides:

createWorkflow in class SimpleWorkflowManager

Throws:

WorkflowException

createWorkflow

public void createWorkflow(User creator,
                           JiraWorkflow workflow)
                    throws WorkflowException

Specified by:

createWorkflow in interface WorkflowManager

Overrides:

createWorkflow in class SimpleWorkflowManager

Throws:

WorkflowException

saveWorkflowWithoutAudit

public void saveWorkflowWithoutAudit(JiraWorkflow workflow)
                              throws WorkflowException

Description copied from interface: WorkflowManager

This method will save the workflow and it will not affect the updatedDate and updatedAuthorName meta attributes of the workflow. This should only ever be invoked by system operations such as upgrade tasks. All other saves should use the method WorkflowManager.updateWorkflow(String, JiraWorkflow)

Specified by:

saveWorkflowWithoutAudit in interface WorkflowManager

Overrides:

saveWorkflowWithoutAudit in class SimpleWorkflowManager

Parameters:

workflow - the workflow to save.

Throws:

WorkflowException

getWorkflowSchemeManager

protected WorkflowSchemeManager getWorkflowSchemeManager()

deleteWorkflow

public void deleteWorkflow(JiraWorkflow workflow)
                    throws WorkflowException

Specified by:

deleteWorkflow in interface WorkflowManager

Overrides:

deleteWorkflow in class SimpleWorkflowManager

Throws:

WorkflowException

getWorkflow

public JiraWorkflow getWorkflow(org.ofbiz.core.entity.GenericValue issue)
                         throws WorkflowException

Description copied from interface: WorkflowManager

Retrieve the workflow for a given issue.

Specified by:

getWorkflow in interface WorkflowManager

Overrides:

getWorkflow in class SimpleWorkflowManager

Throws:

WorkflowException

migrateIssueToWorkflow

public void migrateIssueToWorkflow(org.ofbiz.core.entity.GenericValue issue,
                                   JiraWorkflow newWorkflow,
                                   org.ofbiz.core.entity.GenericValue newStatus)
                            throws WorkflowException

Specified by:

migrateIssueToWorkflow in interface WorkflowManager

Overrides:

migrateIssueToWorkflow in class SimpleWorkflowManager

Throws:

WorkflowException

overwriteActiveWorkflow

public void overwriteActiveWorkflow(String username,
                                    String workflowName)

Description copied from interface: WorkflowManager

Saves the draft workflow into the active workflow.

Specified by:

overwriteActiveWorkflow in interface WorkflowManager

Overrides:

overwriteActiveWorkflow in class SimpleWorkflowManager

Parameters:

username - User will be added to the workflows Audit trail

workflowName - The workflow to be overwritten

updateIssueStatusAndUpdatedDate

protected void updateIssueStatusAndUpdatedDate(org.ofbiz.core.entity.GenericValue issue,
                                               org.ofbiz.core.entity.GenericValue newStatus)

updateWorkflow

public void updateWorkflow(String username,
                           JiraWorkflow workflow)

Description copied from interface: WorkflowManager

Saves the given JiraWorkflow, which may be either a "live" or "draft" version. This method does not save the changes to the active workflow. Instead, this is meant to be used to make persistent changes to your working edit. Once all changes have been made you can over write the active workflow by calling WorkflowManager.overwriteActiveWorkflow(String, String)

Specified by:

updateWorkflow in interface WorkflowManager

Overrides:

updateWorkflow in class SimpleWorkflowManager

Parameters:

username - User making the request.

workflow - The JiraWorkflow to save.

copyWorkflow

public JiraWorkflow copyWorkflow(String username,
                                 String clonedWorkflowName,
                                 String clonedWorkflowDescription,
                                 JiraWorkflow workflowToClone)

Description copied from interface: WorkflowManager

Clones a workflow by creating a deep copy of the workflow provided.

Specified by:

copyWorkflow in interface WorkflowManager

Overrides:

copyWorkflow in class SimpleWorkflowManager

Parameters:

username - The user performing the operation

clonedWorkflowName - The name to store the new workflow with.

clonedWorkflowDescription - The description to store with the cloned workflow. Can be null.

workflowToClone - The workflow to copy.

Returns:

A cloned copy of the original workflow.

updateWorkflowNameAndDescription

public void updateWorkflowNameAndDescription(String username,
                                             JiraWorkflow currentWorkflow,
                                             String newName,
                                             String newDescription)

Description copied from interface: WorkflowManager

Used to change the name and description of an existing worfklow with the given name.

Specified by:

updateWorkflowNameAndDescription in interface WorkflowManager

Overrides:

updateWorkflowNameAndDescription in class SimpleWorkflowManager

Parameters:

username - The user performing the operation

currentWorkflow - The workflow to update.

newName - The new name to save with the workflow

newDescription - The new descriptio to save with the workflow