org.dspace.xmlworkflow

Class XmlWorkflowServiceImpl

java.lang.Object

org.dspace.xmlworkflow.XmlWorkflowServiceImpl

All Implemented Interfaces:

WorkflowService<XmlWorkflowItem>, XmlWorkflowService

public class XmlWorkflowServiceImpl
extends Object
implements XmlWorkflowService

When an item is submitted and is somewhere in a workflow, it has a row in the WorkflowItem table pointing to it. Once the item has completed the workflow it will be archived

Author:

Bram De Schouwer (bram.deschouwer at dot com), Kevin Van de Velde (kevin at atmire dot com), Ben Bosman (ben at atmire dot com), Mark Diggory (markd at atmire dot com)

Field Summary

Fields

Modifier and Type	Field and Description
protected AuthorizeService	authorizeService
protected ClaimedTaskService	claimedTaskService
protected CollectionRoleService	collectionRoleService
protected GroupService	groupService
protected HandleService	handleService
protected InstallItemService	installItemService
protected ItemService	itemService
protected Map<UUID,Boolean>	noEMail
protected PoolTaskService	poolTaskService
protected WorkflowItemRoleService	workflowItemRoleService
protected WorkflowRequirementsService	workflowRequirementsService
protected WorkspaceItemService	workspaceItemService
protected XmlWorkflowFactory	xmlWorkflowFactory
protected XmlWorkflowItemService	xmlWorkflowItemService

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	XmlWorkflowServiceImpl()

Method Summary

Methods

Modifier and Type	Method and Description
WorkspaceItem	abort(Context c, XmlWorkflowItem wi, EPerson e) abort() aborts a workflow, completely deleting it (administrator do this) (it will basically do a reject from any state - the item ends up back in the user's PersonalWorkspace
protected void	activateFirstStep(Context context, Workflow wf, Step firstStep, XmlWorkflowItem wfi)
protected void	addGroupPolicyToItem(Context context, Item item, int type, Group group)
void	addInitialWorkspaceItemPolicies(Context context, WorkspaceItem workspaceItem)
protected void	addPolicyToItem(Context context, Item item, int type, EPerson epa)
void	alertUsersOnTaskActivation(Context c, XmlWorkflowItem wfi, String emailTemplate, List<EPerson> epa, String... arguments)
Item	archive(Context context, XmlWorkflowItem wfi) Commit the contained item to the main archive.
void	createOwnedTask(Context context, XmlWorkflowItem wi, Step step, WorkflowActionConfig action, EPerson e)
void	createPoolTasks(Context context, XmlWorkflowItem wi, RoleMembers assignees, Step step, WorkflowActionConfig action)
void	deleteAllPooledTasks(Context context, XmlWorkflowItem wi)
void	deleteAllTasks(Context context, XmlWorkflowItem wi) Deletes all tasks from this workflowflowitem
void	deleteClaimedTask(Context c, XmlWorkflowItem wi, ClaimedTask task)
void	deleteCollection(Context context, Collection collection)
void	deletePooledTask(Context context, XmlWorkflowItem wi, PoolTask task)
WorkflowActionConfig	doState(Context c, EPerson user, javax.servlet.http.HttpServletRequest request, int workflowItemId, Workflow workflow, WorkflowActionConfig currentActionConfig)
List<String>	getEPersonDeleteConstraints(Context context, EPerson ePerson)
String	getEPersonName(EPerson ePerson)
List<String>	getFlywayMigrationLocations()
String	getMyDSpaceLink()
Group	getWorkflowRoleGroup(Context context, Collection collection, String roleName, Group roleGroup)
protected void	grantGroupAllItemPolicies(Context context, Item item, Group group)
protected void	grantSubmitterReadPolicies(Context context, Item item)
protected void	grantUserAllItemPolicies(Context context, Item item, EPerson epa)
protected void	logWorkflowEvent(Context c, String workflowId, String previousStepId, String previousActionConfigId, XmlWorkflowItem wfi, EPerson actor, Step newStep, WorkflowActionConfig newActionConfig)
protected void	notifyOfArchive(Context context, Item item, Collection coll) notify the submitter that the item is archived
protected void	notifyOfReject(Context c, XmlWorkflowItem wi, EPerson e, String reason)
protected WorkflowActionConfig	processNextStep(Context c, EPerson user, Workflow workflow, ActionResult currentOutcome, XmlWorkflowItem wfi, Step nextStep)
WorkflowActionConfig	processOutcome(Context c, EPerson user, Workflow workflow, Step currentStep, WorkflowActionConfig currentActionConfig, ActionResult currentOutcome, XmlWorkflowItem wfi, boolean enteredNewStep)
protected void	recordStart(Context context, Item myitem, Action action)
protected void	removeGroupItemPolicies(Context context, Item item, Group e)
protected void	removeUserItemPolicies(Context context, Item item, EPerson e)
protected WorkspaceItem	returnToWorkspace(Context c, XmlWorkflowItem wfi) Return the workflow item to the workspace of the submitter.
WorkspaceItem	sendWorkflowItemBackSubmission(Context context, XmlWorkflowItem wi, EPerson e, String provenance, String rejection_message)
XmlWorkflowItem	start(Context context, WorkspaceItem wsi) startWorkflow() begins a workflow - in a single transaction do away with the PersonalWorkspace entry and turn it into a WorkflowItem.
XmlWorkflowItem	startWithoutNotify(Context context, WorkspaceItem wsi) startWithoutNotify() starts the workflow normally, but disables notifications (useful for large imports,) for the first workflow step - subsequent notifications happen normally

Methods inherited from class java.lang.Object

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

Field Detail

noEMail

protected Map<UUID,Boolean> noEMail

authorizeService

@Autowired(required=true)
protected AuthorizeService authorizeService

collectionRoleService

@Autowired(required=true)
protected CollectionRoleService collectionRoleService

claimedTaskService

@Autowired(required=true)
protected ClaimedTaskService claimedTaskService

handleService

@Autowired(required=true)
protected HandleService handleService

installItemService

@Autowired(required=true)
protected InstallItemService installItemService

itemService

@Autowired(required=true)
protected ItemService itemService

poolTaskService

@Autowired(required=true)
protected PoolTaskService poolTaskService

workflowItemRoleService

@Autowired(required=true)
protected WorkflowItemRoleService workflowItemRoleService

workflowRequirementsService

@Autowired(required=true)
protected WorkflowRequirementsService workflowRequirementsService

xmlWorkflowFactory

@Autowired(required=true)
protected XmlWorkflowFactory xmlWorkflowFactory

workspaceItemService

@Autowired(required=true)
protected WorkspaceItemService workspaceItemService

xmlWorkflowItemService

@Autowired(required=true)
protected XmlWorkflowItemService xmlWorkflowItemService

groupService

@Autowired(required=true)
protected GroupService groupService

Constructor Detail

XmlWorkflowServiceImpl

protected XmlWorkflowServiceImpl()

Method Detail

addInitialWorkspaceItemPolicies

public void addInitialWorkspaceItemPolicies(Context context,
                                   WorkspaceItem workspaceItem)
                                     throws SQLException,
                                            AuthorizeException

Specified by:

addInitialWorkspaceItemPolicies in interface WorkflowService<XmlWorkflowItem>

Throws:

SQLException

AuthorizeException

deleteCollection

public void deleteCollection(Context context,
                    Collection collection)
                      throws SQLException,
                             IOException,
                             AuthorizeException

Specified by:

deleteCollection in interface WorkflowService<XmlWorkflowItem>

Throws:

SQLException

IOException

AuthorizeException

getEPersonDeleteConstraints

public List<String> getEPersonDeleteConstraints(Context context,
                                       EPerson ePerson)
                                         throws SQLException

Specified by:

getEPersonDeleteConstraints in interface WorkflowService<XmlWorkflowItem>

Throws:

SQLException

getWorkflowRoleGroup

public Group getWorkflowRoleGroup(Context context,
                         Collection collection,
                         String roleName,
                         Group roleGroup)
                           throws SQLException,
                                  IOException,
                                  WorkflowException,
                                  AuthorizeException

Specified by:

getWorkflowRoleGroup in interface WorkflowService<XmlWorkflowItem>

Throws:

SQLException

IOException

WorkflowException

AuthorizeException

getFlywayMigrationLocations

public List<String> getFlywayMigrationLocations()

Specified by:

getFlywayMigrationLocations in interface WorkflowService<XmlWorkflowItem>

start

public XmlWorkflowItem start(Context context,
                    WorkspaceItem wsi)
                      throws SQLException,
                             AuthorizeException,
                             IOException,
                             WorkflowException

Description copied from interface: WorkflowService

startWorkflow() begins a workflow - in a single transaction do away with the PersonalWorkspace entry and turn it into a WorkflowItem.

Specified by:

start in interface WorkflowService<XmlWorkflowItem>

Parameters:

context - Context

wsi - The WorkspaceItem to convert to a workflow item

Returns:

The resulting workflow item

Throws:

SQLException

AuthorizeException

IOException

WorkflowException

startWithoutNotify

public XmlWorkflowItem startWithoutNotify(Context context,
                                 WorkspaceItem wsi)
                                   throws SQLException,
                                          AuthorizeException,
                                          IOException,
                                          WorkflowException

startWithoutNotify() starts the workflow normally, but disables notifications (useful for large imports,) for the first workflow step - subsequent notifications happen normally

Specified by:

startWithoutNotify in interface WorkflowService<XmlWorkflowItem>

Throws:

SQLException

AuthorizeException

IOException

WorkflowException

alertUsersOnTaskActivation

public void alertUsersOnTaskActivation(Context c,
                              XmlWorkflowItem wfi,
                              String emailTemplate,
                              List<EPerson> epa,
                              String... arguments)
                                throws IOException,
                                       SQLException,
                                       javax.mail.MessagingException

Specified by:

alertUsersOnTaskActivation in interface XmlWorkflowService

Throws:

IOException

SQLException

javax.mail.MessagingException

grantSubmitterReadPolicies

protected void grantSubmitterReadPolicies(Context context,
                              Item item)
                                   throws SQLException,
                                          AuthorizeException

Throws:

SQLException

AuthorizeException

activateFirstStep

protected void activateFirstStep(Context context,
                     Workflow wf,
                     Step firstStep,
                     XmlWorkflowItem wfi)
                          throws AuthorizeException,
                                 IOException,
                                 SQLException,
                                 WorkflowException,
                                 WorkflowConfigurationException

Throws:

AuthorizeException

IOException

SQLException

WorkflowException

WorkflowConfigurationException

doState

public WorkflowActionConfig doState(Context c,
                           EPerson user,
                           javax.servlet.http.HttpServletRequest request,
                           int workflowItemId,
                           Workflow workflow,
                           WorkflowActionConfig currentActionConfig)
                             throws SQLException,
                                    AuthorizeException,
                                    IOException,
                                    javax.mail.MessagingException,
                                    WorkflowException

Specified by:

doState in interface XmlWorkflowService

Throws:

SQLException

AuthorizeException

IOException

javax.mail.MessagingException

WorkflowException

processOutcome

public WorkflowActionConfig processOutcome(Context c,
                                  EPerson user,
                                  Workflow workflow,
                                  Step currentStep,
                                  WorkflowActionConfig currentActionConfig,
                                  ActionResult currentOutcome,
                                  XmlWorkflowItem wfi,
                                  boolean enteredNewStep)
                                    throws IOException,
                                           AuthorizeException,
                                           SQLException,
                                           WorkflowException

Specified by:

processOutcome in interface XmlWorkflowService

Throws:

IOException

AuthorizeException

SQLException

WorkflowException

logWorkflowEvent

protected void logWorkflowEvent(Context c,
                    String workflowId,
                    String previousStepId,
                    String previousActionConfigId,
                    XmlWorkflowItem wfi,
                    EPerson actor,
                    Step newStep,
                    WorkflowActionConfig newActionConfig)
                         throws SQLException

Throws:

SQLException

processNextStep

protected WorkflowActionConfig processNextStep(Context c,
                                   EPerson user,
                                   Workflow workflow,
                                   ActionResult currentOutcome,
                                   XmlWorkflowItem wfi,
                                   Step nextStep)
                                        throws SQLException,
                                               IOException,
                                               AuthorizeException,
                                               WorkflowException,
                                               WorkflowConfigurationException

Throws:

SQLException

IOException

AuthorizeException

WorkflowException

WorkflowConfigurationException

archive

public Item archive(Context context,
           XmlWorkflowItem wfi)
             throws SQLException,
                    IOException,
                    AuthorizeException

Commit the contained item to the main archive. The item is associated with the relevant collection, added to the search index, and any other tasks such as assigning dates are performed.

Specified by:

archive in interface WorkflowService<XmlWorkflowItem>

Returns:

the fully archived item.

Throws:

SQLException

IOException

AuthorizeException

notifyOfArchive

protected void notifyOfArchive(Context context,
                   Item item,
                   Collection coll)
                        throws SQLException,
                               IOException

notify the submitter that the item is archived

Throws:

SQLException

IOException

deleteAllTasks

public void deleteAllTasks(Context context,
                  XmlWorkflowItem wi)
                    throws SQLException,
                           AuthorizeException

Deletes all tasks from this workflowflowitem

Specified by:

deleteAllTasks in interface XmlWorkflowService

Parameters:

context - the dspace context

wi - the workflow item for whom we are to delete the tasks

Throws:

SQLException - ...

AuthorizeException - ...

deleteAllPooledTasks

public void deleteAllPooledTasks(Context context,
                        XmlWorkflowItem wi)
                          throws SQLException,
                                 AuthorizeException

Specified by:

deleteAllPooledTasks in interface XmlWorkflowService

Throws:

SQLException

AuthorizeException

deletePooledTask

public void deletePooledTask(Context context,
                    XmlWorkflowItem wi,
                    PoolTask task)
                      throws SQLException,
                             AuthorizeException

Specified by:

deletePooledTask in interface XmlWorkflowService

Throws:

SQLException

AuthorizeException

deleteClaimedTask

public void deleteClaimedTask(Context c,
                     XmlWorkflowItem wi,
                     ClaimedTask task)
                       throws SQLException,
                              AuthorizeException

Specified by:

deleteClaimedTask in interface XmlWorkflowService

Throws:

SQLException

AuthorizeException

createPoolTasks

public void createPoolTasks(Context context,
                   XmlWorkflowItem wi,
                   RoleMembers assignees,
                   Step step,
                   WorkflowActionConfig action)
                     throws SQLException,
                            AuthorizeException

Specified by:

createPoolTasks in interface XmlWorkflowService

Throws:

SQLException

AuthorizeException

createOwnedTask

public void createOwnedTask(Context context,
                   XmlWorkflowItem wi,
                   Step step,
                   WorkflowActionConfig action,
                   EPerson e)
                     throws SQLException,
                            AuthorizeException

Specified by:

createOwnedTask in interface XmlWorkflowService

Throws:

SQLException

AuthorizeException

grantUserAllItemPolicies

protected void grantUserAllItemPolicies(Context context,
                            Item item,
                            EPerson epa)
                                 throws AuthorizeException,
                                        SQLException

Throws:

AuthorizeException

SQLException

grantGroupAllItemPolicies

protected void grantGroupAllItemPolicies(Context context,
                             Item item,
                             Group group)
                                  throws AuthorizeException,
                                         SQLException

Throws:

AuthorizeException

SQLException

addPolicyToItem

protected void addPolicyToItem(Context context,
                   Item item,
                   int type,
                   EPerson epa)
                        throws AuthorizeException,
                               SQLException

Throws:

AuthorizeException

SQLException

addGroupPolicyToItem

protected void addGroupPolicyToItem(Context context,
                        Item item,
                        int type,
                        Group group)
                             throws AuthorizeException,
                                    SQLException

Throws:

AuthorizeException

SQLException

removeUserItemPolicies

protected void removeUserItemPolicies(Context context,
                          Item item,
                          EPerson e)
                               throws SQLException,
                                      AuthorizeException

Throws:

SQLException

AuthorizeException

removeGroupItemPolicies

protected void removeGroupItemPolicies(Context context,
                           Item item,
                           Group e)
                                throws SQLException,
                                       AuthorizeException

Throws:

SQLException

AuthorizeException

sendWorkflowItemBackSubmission

public WorkspaceItem sendWorkflowItemBackSubmission(Context context,
                                           XmlWorkflowItem wi,
                                           EPerson e,
                                           String provenance,
                                           String rejection_message)
                                             throws SQLException,
                                                    AuthorizeException,
                                                    IOException

Specified by:

sendWorkflowItemBackSubmission in interface WorkflowService<XmlWorkflowItem>

Throws:

SQLException

AuthorizeException

IOException

abort

public WorkspaceItem abort(Context c,
                  XmlWorkflowItem wi,
                  EPerson e)
                    throws AuthorizeException,
                           SQLException,
                           IOException

Description copied from interface: WorkflowService

abort() aborts a workflow, completely deleting it (administrator do this) (it will basically do a reject from any state - the item ends up back in the user's PersonalWorkspace

Specified by:

abort in interface WorkflowService<XmlWorkflowItem>

Parameters:

c - Context

wi - WorkflowItem to operate on

e - EPerson doing the operation

Throws:

AuthorizeException

SQLException

IOException

returnToWorkspace

protected WorkspaceItem returnToWorkspace(Context c,
                              XmlWorkflowItem wfi)
                                   throws SQLException,
                                          IOException,
                                          AuthorizeException

Return the workflow item to the workspace of the submitter. The workflow item is removed, and a workspace item created.

Parameters:

c - Context

wfi - WorkflowItem to be 'dismantled'

Returns:

the workspace item

Throws:

IOException - ...

SQLException - ...

AuthorizeException - ...

getEPersonName

public String getEPersonName(EPerson ePerson)

Specified by:

getEPersonName in interface XmlWorkflowService

recordStart

protected void recordStart(Context context,
               Item myitem,
               Action action)
                    throws SQLException,
                           IOException,
                           AuthorizeException

Throws:

SQLException

IOException

AuthorizeException

notifyOfReject

protected void notifyOfReject(Context c,
                  XmlWorkflowItem wi,
                  EPerson e,
                  String reason)

getMyDSpaceLink

public String getMyDSpaceLink()

Specified by:

getMyDSpaceLink in interface WorkflowService<XmlWorkflowItem>