/* Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package org.activiti.rest.service.api.runtime.task; import java.util.ArrayList; import java.util.Collection; import java.util.HashMap; import java.util.List; import java.util.Map; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import org.activiti.engine.ActivitiIllegalArgumentException; import org.activiti.engine.task.Task; import org.activiti.rest.exception.ActivitiConflictException; import org.activiti.rest.service.api.RestResponseFactory; import org.activiti.rest.service.api.engine.variable.RestVariable; import org.activiti.rest.service.api.engine.variable.RestVariable.RestVariableScope; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.http.HttpStatus; import org.springframework.web.bind.annotation.PathVariable; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.RestController; import org.springframework.web.multipart.MultipartHttpServletRequest; import com.fasterxml.jackson.databind.ObjectMapper; /** * @author Frederik Heremans */ @RestController public class TaskVariableCollectionResource extends TaskVariableBaseResource { @Autowired protected ObjectMapper objectMapper; @RequestMapping(value="/runtime/tasks/{taskId}/variables", method = RequestMethod.GET, produces="application/json") public List<RestVariable> getVariables(@PathVariable String taskId, @RequestParam(value="scope", required=false) String scope, HttpServletRequest request) { List<RestVariable> result = new ArrayList<RestVariable>(); Map<String, RestVariable> variableMap = new HashMap<String, RestVariable>(); // Check if it's a valid task to get the variables for Task task = getTaskFromRequest(taskId); RestVariableScope variableScope = RestVariable.getScopeFromString(scope); if (variableScope == null) { // Use both local and global variables addLocalVariables(task, variableMap); addGlobalVariables(task, variableMap); } else if(variableScope == RestVariableScope.GLOBAL) { addGlobalVariables(task, variableMap); } else if(variableScope == RestVariableScope.LOCAL) { addLocalVariables(task, variableMap); } // Get unique variables from map result.addAll(variableMap.values()); return result; } @RequestMapping(value="/runtime/tasks/{taskId}/variables", method = RequestMethod.PUT, produces="application/json") public Object createOrUpdateTaskVariable(@PathVariable String taskId, HttpServletRequest request, HttpServletResponse response) { Task task = getTaskFromRequest(taskId); return createOrUpdateTaskVariables(request, response, task, true); } @RequestMapping(value="/runtime/tasks/{taskId}/variables", method = RequestMethod.POST, produces="application/json") public Object createTaskVariable(@PathVariable String taskId, HttpServletRequest request, HttpServletResponse response) { Task task = getTaskFromRequest(taskId); return createOrUpdateTaskVariables(request, response, task, false); } private Object createOrUpdateTaskVariables(HttpServletRequest request, HttpServletResponse response, Task task, boolean override) { Object result = null; if (request instanceof MultipartHttpServletRequest) { result = setBinaryVariable((MultipartHttpServletRequest) request, task, true); } else { List<RestVariable> inputVariables = new ArrayList<RestVariable>(); List<RestVariable> resultVariables = new ArrayList<RestVariable>(); result = resultVariables; try { @SuppressWarnings("unchecked") List<Object> variableObjects = (List<Object>) objectMapper.readValue(request.getInputStream(), List.class); for (Object restObject : variableObjects) { RestVariable restVariable = objectMapper.convertValue(restObject, RestVariable.class); inputVariables.add(restVariable); } } catch (Exception e) { throw new ActivitiIllegalArgumentException("Failed to serialize to a RestVariable instance", e); } if (inputVariables == null || inputVariables.size() == 0) { throw new ActivitiIllegalArgumentException("Request didn't contain a list of variables to create."); } RestVariableScope sharedScope = null; RestVariableScope varScope = null; Map<String, Object> variablesToSet = new HashMap<String, Object>(); for (RestVariable var : inputVariables) { // Validate if scopes match varScope = var.getVariableScope(); if (var.getName() == null) { throw new ActivitiIllegalArgumentException("Variable name is required"); } if (varScope == null) { varScope = RestVariableScope.LOCAL; } if (sharedScope == null) { sharedScope = varScope; } if (varScope != sharedScope) { throw new ActivitiIllegalArgumentException("Only allowed to update multiple variables in the same scope."); } if (!override && hasVariableOnScope(task, var.getName(), varScope)) { throw new ActivitiConflictException("Variable '" + var.getName() + "' is already present on task '" + task.getId() + "'."); } Object actualVariableValue = restResponseFactory.getVariableValue(var); variablesToSet.put(var.getName(), actualVariableValue); resultVariables.add(restResponseFactory.createRestVariable(var.getName(), actualVariableValue, varScope, task.getId(), RestResponseFactory.VARIABLE_TASK, false)); } if (!variablesToSet.isEmpty()) { if (sharedScope == RestVariableScope.LOCAL) { taskService.setVariablesLocal(task.getId(), variablesToSet); } else { if (task.getExecutionId() != null) { // Explicitly set on execution, setting non-local variables on task will override local-variables if exists runtimeService.setVariables(task.getExecutionId(), variablesToSet); } else { // Standalone task, no global variables possible throw new ActivitiIllegalArgumentException("Cannot set global variables on task '" + task.getId() +"', task is not part of process."); } } } } response.setStatus(HttpStatus.CREATED.value()); return result; } @RequestMapping(value="/runtime/tasks/{taskId}/variables", method = RequestMethod.DELETE) public void deleteAllLocalTaskVariables(@PathVariable String taskId, HttpServletResponse response) { Task task = getTaskFromRequest(taskId); Collection<String> currentVariables = taskService.getVariablesLocal(task.getId()).keySet(); taskService.removeVariablesLocal(task.getId(), currentVariables); response.setStatus(HttpStatus.NO_CONTENT.value()); } protected void addGlobalVariables(Task task, Map<String, RestVariable> variableMap) { if (task.getExecutionId() != null) { Map<String, Object> rawVariables = runtimeService.getVariables(task.getExecutionId()); List<RestVariable> globalVariables = restResponseFactory.createRestVariables(rawVariables, task.getId(), RestResponseFactory.VARIABLE_TASK, RestVariableScope.GLOBAL); // Overlay global variables over local ones. In case they are present the values are not overridden, // since local variables get precedence over global ones at all times. for (RestVariable var : globalVariables) { if (!variableMap.containsKey(var.getName())) { variableMap.put(var.getName(), var); } } } } protected void addLocalVariables(Task task, Map<String, RestVariable> variableMap) { Map<String, Object> rawVariables = taskService.getVariablesLocal(task.getId()); List<RestVariable> localVariables = restResponseFactory.createRestVariables(rawVariables, task.getId(), RestResponseFactory.VARIABLE_TASK, RestVariableScope.LOCAL); for (RestVariable var : localVariables) { variableMap.put(var.getName(), var); } } }