/*
* Copyright (C) 2005-2010 Alfresco Software Limited.
*
* This file is part of Alfresco
*
* Alfresco is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* Alfresco is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with Alfresco. If not, see .
*/
package org.alfresco.repo.workflow;
import java.io.Serializable;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import org.alfresco.service.cmr.repository.NodeRef;
import org.alfresco.service.cmr.repository.NodeService;
import org.alfresco.service.cmr.workflow.WorkflowService;
import org.alfresco.service.cmr.workflow.WorkflowTask;
import org.alfresco.service.namespace.QName;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
/**
* A helper class for updating and transitioning {@link WorkflowTask
* WorkflowTasks}. This is a stateful object that accumulates a set of updates
* to a task and then commits all the updates when either the update() or
* transition() method is called.
*
* @since 3.4
* @author Nick Smith
*/
public class TaskUpdater
{
/** Logger */
private static final Log LOGGER = LogFactory.getLog(TaskUpdater.class);
private final String taskId;
private final WorkflowService workflowService;
private final PackageManager packageMgr;
private final Map properties = new HashMap();
private final Map> add = new HashMap>();
private final Map> remove = new HashMap>();
public TaskUpdater(String taskId,
WorkflowService workflowService,
NodeService nodeService)
{
this.taskId = taskId;
this.workflowService = workflowService;
this.packageMgr = new PackageManager(workflowService, nodeService, LOGGER);
}
public void addProperty(QName name, Serializable value)
{
properties.put(name, value);
}
public void addAssociation(QName name, List value)
{
add.put(name, value);
}
public void removeAssociation(QName name, List value)
{
remove.put(name, value);
}
public boolean changeAssociation(QName name, String nodeRefs, boolean isAdd)
{
List value = NodeRef.getNodeRefs(nodeRefs, LOGGER);
if (value == null)
{
return false;
}
Map> map = getAssociationMap(isAdd);
if (map != null)
{
map.put(name, value);
return true;
}
return false;
}
/**
* @param suffix
* @return
*/
private Map> getAssociationMap(boolean isAdd)
{
Map> map = null;
if (isAdd)
{
map = add;
}
else
{
map = remove;
}
return map;
}
public void addPackageItems(List items)
{
packageMgr.addItems(items);
}
public void removePackageItems(List items)
{
packageMgr.removeItems(items);
}
public WorkflowTask transition()
{
return transition(null);
}
public WorkflowTask transition(String transitionId)
{
update();
return workflowService.endTask(taskId, transitionId);
}
public WorkflowTask update()
{
WorkflowTask task = workflowService.getTaskById(taskId);
NodeRef packageNode = task.getPath().getInstance().getWorkflowPackage();
packageMgr.update(packageNode);
WorkflowTask result = workflowService.updateTask(taskId, properties, add, remove);
properties.clear();
add.clear();
remove.clear();
return result;
}
}