/* * 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; } }