1. /**
    2.      * 通过任务id跳转到上一步任务
    3.      * @param taskId 任务id
    4.      * @return
    5.      */
    6.     @Override
    7.     public String executeAndJumpOneTask(String taskId) {
    8.         try {
    9.             /** 取得当前需要撤回的任务 ***/
    10.             HistoricTaskInstance currTask = historyService
    11.                     .createHistoricTaskInstanceQuery().taskId(taskId)
    12.                     .singleResult();
    14.             /** 获取当前任务所属流程定义，进而获取流程定义key **/
    15.             ProcessDefinition processDefinition = repositoryService.getProcessDefinition(currTask.getProcessDefinitionId());
    17.             /** 获取当前任务的前一个任务id **/
    18.             String taskHisId = getPrevTaskByCurrentTaskId(processDefinition.getKey(),currTask.getProcessInstanceId(),taskId);
    20.             /** 取回流程节点 taskId当前任务id，taskHisId需要取回的任务的id***/
    21.             callBackProcess(taskId,taskHisId);
    22.             //删除历史流程走向记录
    23.             historyService.deleteHistoricTaskInstance(currTask.getId());
    24.             historyService.deleteHistoricTaskInstance(taskId);
    25.         } catch (Exception e) {
    26.             return "撤回失败 ：" + e.getMessage();
    27.         }
    29.         return "success";
    30.     }
    33.     /**
    34.      * 取回流程中当前任务的上一个任务
    35.      * @param taskId 当前任务ID
    36.      * @param activityId 取回节点ID （这里不一定是上一个流程节点id）
    37.      * @throws Exception
    38.      */
    39.     public void callBackProcess(String taskId, String activityId) throws Exception {
    40.         if (StringUtils.isEmpty(activityId)) {
    41.             throw new Exception("目标节点ID为空！");
    42.         }
    43.         //通过任务id获取流程实例id
    44.         String processInstanceId = findProcessInstanceByTaskId(taskId).getId();
    46.         //通过任务id获取任务定义key
    47.         String taskDefinitionKey = findTaskById(taskId).getTaskDefinitionKey();
    49.         // 查找所有并行任务节点，同时取回
    50.         List<Task> taskList = findTaskListByKey(processInstanceId, taskDefinitionKey);
    51.         for (Task task : taskList) {
    52.             commitProcess(task.getId(), null, activityId);
    53.         }
    54.     }
    57.     /**  
    58.      * 提交流程/流程转向 
    59.      * @param taskId 当前任务ID  
    60.      * @param variables 流程变量  
    61.      * @param activityId 流程转向执行任务节点ID,此参数为空，默认为提交操作  
    62.      * @throws Exception  
    63.      */
    64.     private void commitProcess(String taskId, Map<String, Object> variables,
    65.                                String activityId) throws Exception {
    66.         if (variables == null) {
    67.             variables = new HashMap<String, Object>();
    68.         }
    69.         // 跳转节点为空，默认提交操作
    70.         if (StringUtils.isEmpty(activityId)) {
    71.             taskService.complete(taskId, variables);
    72.         } else {
    73.             // 流程转向操作    
    74.             turnTransition(taskId, activityId, variables);
    75.         }
    76.     }
    78.     /**
    79.      * 流程转向操作
    80.      * @param taskId  当前任务ID
    81.      * @param activityId 目标节点任务ID
    82.      * @param variables 流程变量
    83.      * @throws Exception
    84.      */
    85.     private void turnTransition(String taskId, String activityId, Map<String, Object> variables) throws Exception {
    86.         // 当前节点
    87.         ActivityImpl currActivity = findActivitiImpl(taskId, null);
    88.         // 清空当前流向
    89.         List<PvmTransition> oriPvmTransitionList = clearTransition(currActivity);
    90.         // 创建新流向,即将当前节点的流向指向需要跳转的节点流向
    91.         TransitionImpl newTransition = currActivity.createOutgoingTransition();
    92.         // 目标任务的活动节点
    93.         ActivityImpl pointActivity = findActivitiImpl(taskId, activityId);
    94.         // 设置新流向的目标节点，将当前节点指向需要跳转的节点
    95.         newTransition.setDestination(pointActivity);
    97.         /** 执行转向任务 这种方法转向执行任务获取到的任务id将不再是原来的任务id ***/
    98.         // todo 这里需要将撤回操作的操作人定义为当前登录操作的用户（即撤回用户）？？？？ ***/
    99.         //fixme 算法待修改
    100.         taskService.complete(taskId, variables);
    102.         /** 任务执行完需要将任务还原 ***/
    103.         // 删除目标节点新流入
    104.         pointActivity.getIncomingTransitions().remove(newTransition);
    105.         // 还原以前流向
    106.         restoreTransition(currActivity, oriPvmTransitionList);
    107.     }
    109.     /**
    110.      * 还原指定活动节点流向
    111.      * @param activityImpl 活动节点
    112.      * @param oriPvmTransitionList  原有节点流向集合
    113.      */
    114.     private void restoreTransition(ActivityImpl activityImpl, List<PvmTransition> oriPvmTransitionList) {
    115.         // 清空现有流向
    116.         List<PvmTransition> pvmTransitionList = activityImpl .getOutgoingTransitions();
    117.         pvmTransitionList.clear();
    118.         // 还原以前流向
    119.         for (PvmTransition pvmTransition : oriPvmTransitionList) {
    120.             pvmTransitionList.add(pvmTransition);
    121.         }
    122.     }
    125.     /**
    126.      * 根据任务ID和目标节点ID获取活动节点
    127.      * @param taskId  任务ID
    128.      * @param activityId 活动节点ID，如果为null或""，则默认查询当前活动节点 如果为"end"，则查询结束节点
    129.      * @return
    130.      * @throws Exception
    131.      */
    132.     private ActivityImpl findActivitiImpl(String taskId, String activityId) throws Exception {
    133.         /** 通过当前任务id，取得流程定义 **/
    134.         ProcessDefinitionEntity processDefinition = findProcessDefinitionEntityByTaskId(taskId);
    136.         /** 获取当前活动节点ID，如果目标节点为空，获取当前活动节点 ，不为空，获取目标节点**/
    137.         if (StringUtils.isEmpty(activityId)) {
    138.             activityId = findTaskById(taskId).getTaskDefinitionKey();
    139.         }else{
    140.             HistoricTaskInstance currTask = historyService.createHistoricTaskInstanceQuery().taskId(activityId) .singleResult();
    141.             activityId = currTask.getTaskDefinitionKey();
    142.         }
    144.         /** 根据流程定义，获取该流程实例的结束节点 **/
    145.         if (activityId.toUpperCase().equals("END")) {
    146.             for (ActivityImpl activityImpl : processDefinition.getActivities()) {
    147.                 /** 获取所有当前活动节点的输出节点 **/
    148.                 List<PvmTransition> pvmTransitionList = activityImpl .getOutgoingTransitions();
    150.                 /** 如果当前节点没有输出路径了，那么当前节点为结束节点 **/
    151.                 if (pvmTransitionList.isEmpty()) {
    152.                     return activityImpl;
    153.                 }
    154.             }
    155.         }
    157.         /** 根据节点ID，获取对应的活动节点 **/
    158.         ActivityImpl activityImpl = ((ProcessDefinitionImpl)processDefinition).findActivity(activityId);
    159.         return activityImpl;
    160.     }
    162.     /**
    163.      * 清空指定活动节点流向
    164.      * @param activityImpl 活动节点
    165.      * @return 节点流向集合
    166.      */
    167.     private List<PvmTransition> clearTransition(ActivityImpl activityImpl) {
    168.         // 存储当前节点所有流向临时变量
    169.         List<PvmTransition> oriPvmTransitionList = new ArrayList<PvmTransition>();
    170.         // 获取当前节点所有流向，存储到临时变量，然后清空
    171.         List<PvmTransition> pvmTransitionList = activityImpl .getOutgoingTransitions();
    172.         for (PvmTransition pvmTransition : pvmTransitionList) {
    173.             oriPvmTransitionList.add(pvmTransition);
    174.         }
    175.         pvmTransitionList.clear();
    176.         return oriPvmTransitionList;
    177.     }
    179.     /**
    180.      * 根据任务ID获取流程定义
    181.      * @param taskId  任务ID
    182.      * @return 流程定义实体
    183.      * @throws Exception
    184.      */
    185.     public ProcessDefinitionEntity findProcessDefinitionEntityByTaskId( String taskId) throws Exception {
    186.         // 取得流程定义
    187.         ProcessDefinitionEntity processDefinition = (ProcessDefinitionEntity) ((RepositoryServiceImpl) repositoryService) .getDeployedProcessDefinition(findTaskById(taskId) .getProcessDefinitionId());
    188.         if (processDefinition == null) {
    189.             throw new Exception("流程定义未找到!");
    190.         }
    191.         return processDefinition;
    192.     }
    195.     /**
    196.      * 根据任务ID获得任务实例
    197.      * @param taskId 任务ID
    198.      * @return 任务实例
    199.      * @throws Exception
    200.      */
    201.     private TaskEntity findTaskById(String taskId) throws Exception {
    202.         TaskEntity task = (TaskEntity) taskService.createTaskQuery().taskId(taskId).singleResult();
    203.         if (task == null) {
    204.             throw new Exception("任务实例未找到!");
    205.         }
    206.         return task;
    207.     }
    209.     /**
    210.      * 根据流程实例ID和任务key值查询所有同级任务集合
    211.      * @param processInstanceId  流程实例id
    212.      * @param key 任务定义key
    213.      * @return
    214.      * */
    215.     private List<Task> findTaskListByKey(String processInstanceId, String key) {
    216.         return taskService.createTaskQuery().processInstanceId(processInstanceId).taskDefinitionKey(key).list();
    217.     }
    219.     /**
    220.      * 根据任务ID获取对应的流程实例
    221.      * @param taskId 任务ID
    222.      * @return
    223.      * @throws Exception
    224.      */
    225.     public ProcessInstance findProcessInstanceByTaskId(String taskId) throws Exception {
    226.         // 找到流程实例
    227.         ProcessInstance processInstance = runtimeService.createProcessInstanceQuery().processInstanceId( findTaskById(taskId).getProcessInstanceId()) .singleResult();
    228.         if (processInstance == null) {
    229.             throw new Exception("流程实例未找到!");
    230.         }
    231.         return processInstance;
    232.     }
    235.     /**
    236.      * 通过流程定义key和当前任务id来获取流程图中，当前任务所处节点的上一个节点信息
    237.      * @param dkey
    238.      * @param currentTaskId
    239.      *  1.通过taskId获得executionid
    240.      *  2.通过executionId获得currentActivityId
    241.      *  3.通过currentActivityId获得ActivityImpl对象
    242.      *  4.通过ActivityImpl对象获得incomingTransitions()
    243.      *  5.通过transitionImpl对象获得source（ActivityImpl类型）
    244.      *  6.通过ActivityImpl获得activityId
    245.      *  7.通过activityId（这个activityId就是当前任务所在节点的前一个节点了）在流程历史里查询对应的task。
    246.      * @return
    247.      */
    248.     public List<String> getPrevActivitiByCurrentTaskId(String dkey,String currentTaskId){
    249.         /** 用于存储当前节点的所有上一个节点id **/
    250.         List<String>  preTaskIds = new ArrayList<>();
    251.         //任务查询条件
    252.         TaskQuery taskQuery = taskService.createTaskQuery();
    253.         //流程实力查询条件
    254.         ExecutionQuery executionQuery = runtimeService.createExecutionQuery();
    256.         //获取当前任务
    257.         Task task = taskQuery.taskId(currentTaskId).singleResult();
    258.         if(task != null){
    259.             //获取当前流程任务的执行路线id
    260.             String executionId = task.getExecutionId();
    262.             //获取运行时流程执行实例
    263.             Execution execution = executionQuery.executionId(executionId).singleResult();
    265.             当前流程节点Id信息
    266.             String activityId = execution.getActivityId();
    268.             /** 根据流程定义的key获取流程定义所有的activity模型时期对象，即获取待所有的流程组件对象信息 ***/
    269.             List<ActivityImpl> allActivities = getAllActivities(dkey);
    270.             for(ActivityImpl activity : allActivities){
    272.                 /** 当获取到当前节点的时候，才执行之后的操作，主要需要通过当前节点来获取指向该节点的上一个节点 **/
    273.                 String id = activity.getId();
    274.                 if(!id.equals(activityId)){
    275.                     continue;
    276.                 }
    278.                 /** PVM
    279.                  PVM:Process Virtal Machine,流程虚拟机API暴露了流程虚拟机的POJO核心，
    280.                  流程虚拟机API描述了一个工作流流程必备的组件，这些组件包括：
    281.                  PvmProcessDefinition：流程的定义，形象点说就是用户画的那个图。静态含义。
    282.                  PvmProcessInstance：流程实例，用户发起的某个PvmProcessDefinition的一个实例，动态含义。
    283.                  PvmActivity：流程中的一个节点
    284.                  PvmTransition：衔接各个节点之间的路径，形象点说就是图中各个节点之间的连接线。
    285.                  PvmEvent：流程执行过程中触发的事件 **/
    286.                 /** 这里获取 当前活动的所有入口 ,首先获取指向该节点的所有路径**/
    287.                 List<PvmTransition> incomingTransitions = activity.getIncomingTransitions();
    289.                 /** 遍历路径，获取路径的源节点， 然后通过远点获取源节点的id，保存到集合中**/
    290.                 for(PvmTransition transition : incomingTransitions){
    291.                     //获取路径源节点
    292.                     PvmActivity source = transition.getSource();
    293.                     //源节点id
    294.                     String preTaskId = source.getId();
    295.                     //加入集合
    296.                     preTaskIds.add(preTaskId);
    297.                 }
    298.             }
    299.         }
    300.         return preTaskIds;
    301.     }
    304.     /**
    305.      * 通过当前任务id获取前一个任务
    306.      * @param dkey 流程定义key
    307.      * @param processInstanceId 流程实例id
    308.      * @param taskId 当前任务id
    309.      * @return 离当当前任务最近的上一个任务
    310.      */
    311.     public String getPrevTaskByCurrentTaskId(String dkey,String processInstanceId,String taskId){
    312.         HistoricTaskInstance historicTaskInstance = null;
    314.         /** 这里是获取当前流程定义所对应流程图中指向当前节点的所有上一个节点id **/
    315.         List<String> prevTaskIds = getPrevActivitiByCurrentTaskId(dkey, taskId);
    317.         if(prevTaskIds != null && prevTaskIds.size() > 0){
    318.             /** 用于存放当前任务的历史节点信息，在后面进行时间比较，获取最新的上一个节点 **/
    319.             Map<String,HistoricActivityInstance> instanceMap = new HashMap<>();
    321.             /** 遍历当前节点的所有指向当前节点的源节点。判断最新的节点是哪个 **/
    322.             for(String preact : prevTaskIds){
    323.                 /** 根据当前流程实例id获取 HistoricActivityInstance ，HistoricActivityInstance包含一个活动(流程上的节点)的执行信息 **/
    324.                 HistoricActivityInstance activityInstance = historyService.createHistoricActivityInstanceQuery()
    325.                         .processInstanceId(processInstanceId).activityId(preact).singleResult();
    327.                 if(activityInstance == null){
    328.                     continue;
    329.                 }
    331.                 /** 获取当前节点实例的结束时间 ***/
    332.                 Date endTime = activityInstance.getEndTime();
    334.                 /** 这里首先获取上一个遍历存放的历史节点信息**/
    335.                 HistoricActivityInstance activityInstance1 = instanceMap.get(taskId);
    337.                 /** 如果已存放上一个节点信息，那么，进行时间比较，放入最近的时间的历史节点信息，反之加入集合，用于下一个循环比较 **/
    338.                 if(activityInstance1 != null){
    339.                     Date endTime1 = activityInstance1.getEndTime();
    340.                     if(endTime1.after(endTime)){
    341.                         continue;
    342.                     }
    343.                     instanceMap.put(taskId,activityInstance1);
    344.                 }else{
    345.                     instanceMap.put(taskId,activityInstance);
    346.                 }
    348.             }
    350.             /** 获取前一步通过时间比较获取的结束时间最近的当前任务节点的上一个节点 **/
    351.             HistoricActivityInstance activityInstance = instanceMap.get(taskId);
    353.             /** 获取挂接在当前历史节点下的当前任务的上一个任务 **/
    354.             if(activityInstance != null){
    355.                 String hisTaskId = activityInstance.getTaskId();
    356.                 historicTaskInstance = historyService.createHistoricTaskInstanceQuery().processInstanceId(processInstanceId).taskId(hisTaskId).singleResult();
    357.             }
    358.         }
    360.         return historicTaskInstance.getId();
    361.     }
    364.     /**
    365.      * activity 是模型时期对象
    366.      *
    367.      * @params: [dkey 流程定义的key]
    368.      * @return:
    369.      * @描述: 根据流程定义的key获取流程定义所有的activity
    370.      *
    371.      * 释义：在设计流程时每一个组件在Activiti中都可以称之为——Activity，
    372.      *       部署流程时引擎把XML文件保存到数据库；
    373.      *       当启动流程、完成任务时会从数据库读取XML并转换为Java对象，
    374.      *       如果想在处理任务时获取任务的一些配置，
    375.      *       例如某个任务配置了哪些监听器或者条件Flow配置了什么条件表达式，
    376.      *       可以获取具体的Activity。
    377.      */
    378.     public List<ActivityImpl> getAllActivities(String dkey) {
    379.         List<ActivityImpl> activities = new ArrayList<>();
    381.         /** 根据流程定义的key获取流程定义对象 **/
    382.         ProcessDefinition definition = repositoryService.createProcessDefinitionQuery().processDefinitionKey(dkey).singleResult();
    383.         ProcessDefinitionEntity processDefinition = (ProcessDefinitionEntity) ((RepositoryServiceImpl) repositoryService)
    384.                 .getDeployedProcessDefinition(definition.getId());
    386.         /** 获取所有的activity -- 即获取所有节点信息**/
    387.         activities = processDefinition.getActivities();
    389.         return activities;
    390.     }