Activiti——工作流之流程实例、任务的执行（五）

转自：http://profound-accumulation.iteye.com/blog/2244881

一、流程图

  二、部署流程定义

/**部署请假流程（从zip）*/  
    @Test  
    public void deploymentProcessDefinition_zip(){  
        InputStream in = this.getClass().getClassLoader().getResourceAsStream("diagrams/leave.zip");  
        ZipInputStream zipInputStream = new ZipInputStream(in);  
        Deployment deployment = processEngine.getRepositoryService()/**与请假流程和部署对象相关的Service*/  
                        .createDeployment()/**创建一个部署对象*/  
                        .name("请假流程")/**添加部署的名称*/  
                        .addZipInputStream(zipInputStream)/**指定zip格式的文件完成部署*/  
                        .deploy();/**完成部署*/  
        /** 
         * 部署ID：1 
         * 部署名称：请假流程 
         */  
        System.out.println("部署ID："+deployment.getId());//  
        System.out.println("部署名称："+deployment.getName());//  
    }  

三、启动流程实例

/**启动流程实例*/  
    @Test  
    public void startProcessInstance(){  
        /**请假流程的key*/  
        String processDefinitionKey = "leave";  
        ProcessInstance pi = processEngine.getRuntimeService()/**与正在执行的流程实例和执行对象相关的Service*/  
                        .startProcessInstanceByKey(processDefinitionKey);/**使用请假流程的key启动流程实例，key对应leave.bpmn文件中id的属性值，使用key值启动，默认是按照最新版本的请假流程启动*/  
        /** 
         * 流程实例ID:101 
         * 请假流程ID:leave:1:4 
         */  
        System.out.println("流程实例ID:"+pi.getId());  
        System.out.println("请假流程ID:"+pi.getProcessDefinitionId());  
    }  

说明：
1)操作数据库的act_ru_execution表,如果是用户任务节点，同时也会在act_ru_task添加一条记录

四、查询我的个人任务

  /**查询当前人的个人任务:查询act_ru_task表信息*/  
    @Test  
    public void findMyPersonalTask(){  
        /** 
         * 任务ID:104 
         * 任务名称:提交申请 
         */  
        //String assignee = "张三";  
        /** 
         * 任务ID:202 
         * 任务名称:审批【部门经理】 
         */  
        //String assignee = "李四";  
        /** 
         * 任务ID:302 
         * 任务名称:审批【总经理】 
         */  
        String assignee = "王五";  
        List<Task> list = processEngine.getTaskService()/**与正在执行的任务管理相关的Service*/  
                        .createTaskQuery()/**创建任务查询对象*/  
                        /**查询条件（where部分）*/  
                        .taskAssignee(assignee)/**指定个人任务查询，指定办理人*/  
//                      .taskCandidateUser(candidateUser)/**组任务的办理人查询*/  
//                      .processDefinitionId(processDefinitionId)/**使用请假流程ID查询*/  
//                      .processInstanceId(processInstanceId)/**使用流程实例ID查询*/  
//                      .executionId(executionId)/**使用执行对象ID查询*/  
                        /**排序*/  
                        .orderByTaskCreateTime().asc()/**使用创建时间的升序排列*/  
                        /**返回结果集*/  
//                      .singleResult()/**返回惟一结果集*/  
//                      .count()/**返回结果集的数量*/  
//                      .listPage(firstResult, maxResults);/**分页查询*/  
                        .list();/**返回列表*/  
        if(list!=null && list.size()>0){  
            for(Task task:list){  
                System.out.println("任务ID:"+task.getId());  
                System.out.println("任务名称:"+task.getName());  
                System.out.println("任务的创建时间:"+task.getCreateTime());  
                System.out.println("任务的办理人:"+task.getAssignee());  
                System.out.println("流程实例ID："+task.getProcessInstanceId());  
                System.out.println("执行对象ID:"+task.getExecutionId());  
                System.out.println("请假流程ID:"+task.getProcessDefinitionId());  
                System.out.println("########################################################");  
            }  
        }  
    }  

 说明：
1)因为是任务查询，所以从processEngine中应该得到TaskService
2)使用TaskService获取到任务查询对象TaskQuery
3)为查询对象添加查询过滤条件，使用taskAssignee指定任务的办理者（即查询指定用户的代办任务），同时可以添加分页排序等过滤条件
4)调用list方法执行查询，返回办理者为指定用户的任务列表
5)任务ID、名称、办理人、创建时间可以从act_ru_task表中查到。
6)Execution与ProcessInstance稍后详细讲,在这种情况下，ProcessInstance相当于Execution
7)如果assignee属性为部门经理，结果为空。因为现在流程只到了”填写请假申请”阶段，后面的任务还没有执行，即在数据库中没有部门经理可以办理的任务，所以查询不到。
8)一个Task节点和Execution节点是1对1的情况，在task对象中使用Execution_来表示他们之间的关系
9)任务ID在数据库表act_ru_task中对应“ID_”列

附加：
在activiti任务中，主要分为两大类查询任务（个人任务和组任务）：
1.确切指定了办理者的任务，这个任务将成为指定者的私有任务，即个人任务。
2.无法指定具体的某一个人来办理的任务，可以把任务分配给几个人或者一到 多个小组，让这个范围内的用户可以选择性（如有空余时间时）来办理这类任务，即组任务。
先知道个人任务的查询和办理，组任务的操作后面讲

五、办理任务

/**办理任务:完成我的任务*/  
    @Test  
    public void completeMyPersonalTask(){  
        /**任务ID*/  
        //String taskId = "104";  
        //String taskId = "202";  
        String taskId = "302";  
        processEngine.getTaskService()/**与正在执行的任务管理相关的Service*/  
                    .complete(taskId);  
        System.out.println("完成任务：任务ID："+taskId);  
    }  

 说明：
1)是办理任务，所以从ProcessEngine得到的是TaskService。
2)当执行完这段代码，再以员工的身份去执行查询的时候，会发现这个时候已经没有数据了，因为正在执行的任务中没有数据。
3)对于执行完的任务，activiti将从act_ru_task表中删除该任务，下一个任务会被插入进来。
4)以”部门经理”的身份进行查询，可以查到结果。因为流程执行到部门经理审批这个节点了。
5)再执行办理任务代码，执行完以后以”部门经理”身份进行查询，没有结果。
6)重复第3和4步直到流程执行完。

六、查询流程状态（判断流程正在执行，还是结束）

/**查询流程状态（判断流程正在执行，还是结束）*/  
    @Test  
    public void isProcessEnd(){  
        String processInstanceId = "101";  
        ProcessInstance pi = processEngine.getRuntimeService()/**表示正在执行的流程实例和执行对象*/  
                        .createProcessInstanceQuery()/**创建流程实例查询*/  
                        .processInstanceId(processInstanceId)/**使用流程实例ID查询*/  
                        .singleResult();  
        if(pi==null){  
            System.out.println("流程已经结束");  
        }  
        else{  
            System.out.println("流程没有结束");  
        }  
    }  

 在流程执行的过程中，创建的流程实例ID在整个过程中都不会变，当流程结束后，流程实例将会在正在执行的执行对象表中（act_ru_execution）被删除
 说明：
1)因为是查询流程实例，所以先获取runtimeService
2)创建流程实例查询对象，设置实例ID过滤参数
3)由于一个流程实例ID只对应一个实例，使用singleResult执行查询返回一个唯一的结果，如果结果数量大于1，则抛出异常
4)判断指定ID的实例是否存在，如果结果为空，则代表流程结束，实例在正在执行的执行对象表中已被删除，转换成历史数据。

七、查询历史任务

/**查询历史任务(查询act_hi_task表信息)*/  
    @Test  
    public void findHistoryTask(){  
        String taskAssignee = "张三";  
        List<HistoricTaskInstance> list = processEngine.getHistoryService()/**与历史数据（历史表）相关的Service*/  
                        .createHistoricTaskInstanceQuery()/**创建历史任务实例查询*/  
                        .taskAssignee(taskAssignee)/**指定历史任务的办理人*/  
                        .list();  
        if(list!=null && list.size()>0){  
            for(HistoricTaskInstance hti:list){  
                System.out.println(hti.getId()+"    "+hti.getName()+"    "+hti.getProcessInstanceId()+"   "+hti.getStartTime()+"   "+hti.getEndTime()+"   "+hti.getDurationInMillis());  
                System.out.println("################################");  
            }  
        }  
    }  

八、查询历史流程实例

**查询历史流程实例(查询act_hi_actinst表信息)*/  
    @Test  
    public void findHistoryProcessInstance(){  
        String processInstanceId = "101";  
        HistoricProcessInstance hpi = processEngine.getHistoryService()/**与历史数据（历史表）相关的Service*/  
                        .createHistoricProcessInstanceQuery()/**创建历史流程实例查询*/  
                        .processInstanceId(processInstanceId)/**使用流程实例ID查询*/  
                        .singleResult();  
        System.out.println(hpi.getId()+"    "+hpi.getProcessDefinitionId()+"    "+hpi.getStartTime()+"    "+hpi.getEndTime()+"     "+hpi.getDurationInMillis());  
    }  

九、总结
Execution   执行对象
 按流程定义的规则执行一次的过程.
 对应的表：
  act_ru_execution： 正在执行的信息
  act_hi_procinst：已经执行完的历史流程实例信息
  act_hi_actinst：存放历史所有完成的活动
ProcessInstance  流程实例
 特指流程从开始到结束的那个最大的执行分支，一个执行的流程中，流程实例只有1个。

注意
    （1）如果是单例流程，执行对象ID就是流程实例ID
    （2）如果一个流程有分支和聚合，那么执行对象ID和流程实例ID就不相同
    （3）一个流程中，流程实例只有1个，执行对象可以存在多个。

Task 任务
 执行到某任务环节时生成的任务信息。
 对应的表：
  act_ru_task：正在执行的任务信息
  act_hi_taskinst：已经执行完的历史任务信息