Activiti学习笔记六 流程实例 任务 执行对象控制流程执行

上一篇我们看了流程定义，我们接下来看一下流程实例，任务，和执行对象。

 

流程实例 任务的执行

1.流程图

2.部署流程定义

    private final ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();    /**     * 功能: 部署流程定义zip.<br/>     * date: 2014年12月16日 下午2:09:03 <br/>     *      * @author [e-mail]     */    @Test    public void deploymentProcessDefinitionByZip() {        InputStream in = this.getClass().getClassLoader().getResourceAsStream("diagrams/helloworld.zip");        ZipInputStream zipInputStream = new ZipInputStream(in);        Deployment deployment = processEngine.getRepositoryService()        // 与流程定义和部署相关的Service                .createDeployment()                // 创建部署对象                .name("流程定义")                // 部署名称                .addZipInputStream(zipInputStream) // 指定zip文件                .deploy(); // 部署        System.out.println("部署ID：" + deployment.getId());        System.out.println("部署名称：" + deployment.getName());    }

3.启动流程实例

/**     * 功能: 启动流程实例.<br/>     * date: 2014年12月15日 下午5:25:37 <br/>     *      * @author [e-mail]     */    @Test    public void startProcessInstance() {        // 流程定义的key        String processDefinitionKey = "helloworld";        ProcessInstance pi = processEngine.getRuntimeService()// 获取正在执行的流程实例和执行对象相关的Service                .startProcessInstanceByKey(processDefinitionKey); // 使用流程定义的key启动流程实例                                                                  // key                                                                  // 对应helloworld.bpmn中的Id属性        System.out.println(pi.getId()); // 流程实例Id 601        System.out.println(pi.getProcessDefinitionId()); // 流程定义Id                                                         // helloworld:1:504    }

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

 

act_ru_execution #正在执行的执行对象表

   执行对象ID                                                                           流程实例ID

act_hi_procinst   #流程实例的历史表

   执行对象ID                              流程实例ID

 

结论

1.如果是单例流程（没有分支和聚合），那么流程实例ID和执行对象ID是相同的

2.一个流程流程实例只有一个，执行对象可以存在多个（如果存在分支和聚合）

注意：本例是单例流程，要想测试第二个结论，可以再画一张有分支的流程图来测试。

 

4.查询个人任务 

/**     * 功能: 查询当前人的个人任务.<br/>     * date: 2014年12月16日 上午11:00:46 <br/>     *      * @author [e-mail]     */    @Test    public void queryMyTask() {        String assignee = "李四";        List<Task> list = processEngine.getTaskService()// 获取正在执行的任务相关的Service                .createTaskQuery()// 创建任务查询对象                .taskAssignee(assignee)// 指定任务办理人                // .taskCandidateUser(candidateUser) //组任务的办理人查询                // .processDefinitionId(processDefinitionId)//使用流程定义Id查询                // .processInstanceId(processInstanceId) //使用流程实例Id查询                // .executionId(executionId) //使用执行对象Id查询                /** 排序 */                .orderByTaskCreateTime().asc() // 使用创建时间的升序                /** 返回结果集 */                // .singleResult()// 返回唯一结果集                // .count() // 返回结果集的数量                // .listPage(firstResult, maxResults)//分页查询                .list();        if (null != list && 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）单例流程中ProcessInstance相当于Execution

        7）如果assignee属性为部门经理，结果为空。因为现在流程只到了”填写请假申请”阶段，后面的任务还没有执行，即在数据库中没有部门经理可以办理的任务，所以查询不到

        8）一个Task节点和Execution节点是1对1的情况，在task对象中使用Execution_来表示他们之间的关系

        9）任务ID在数据库表act_ru_task中对应“ID_”列

 

附加：

在activiti任务中，主要分为两大类查询任务（个人任务和组任务）：

1.确切指定了办理者的任务，这个任务将成为指定者的私有任务，即个人任务。

2.无法指定具体的某一个人来办理的任务，可以把任务分配给几个人或者一到多个小组，让这个范围内的用户可以选择性（如有空余时间时）来办理这类任务，即组任务。

act_ru_task  #正在执行的任务表

任务ID                                                                                   执行对象ID                          流程实例ID

 

act_hi_taskinst #任务历史表

                                                                                                                                         办理人                       开始时间                                                       结束时间

 

act_hi_actinst #所有活动节点的历史表

 

5.办理任务

/**     * 功能: 完成任务.<br/>     * date: 2014年12月17日 下午5:24:44 <br/>     *      * @author [e-mail]     */    @Test    public void completeMyTask() {        String taskId = "1402";        processEngine.getTaskService()// 获取任务相关Service                .complete(taskId);        System.out.println("完成任务：任务ID：" + taskId);    }

说明：

        1）是办理任务，所以从ProcessEngine得到的是TaskService

        2）当执行完这段代码，再以员工的身份去执行查询的时候，会发现这个时候已经没有数据了，因为正在执行的任务中没有数据

        3）对于执行完的任务，activiti将从act_ru_task表中删除该任务，下一个任务会被插入进来

        4）以”部门经理”的身份进行查询，可以查到结果。因为流程执行到部门经理审批这个节点了

        5）再执行办理任务代码，执行完以后以”部门经理”身份进行查询，没有结果、

        6）重复第3和4步直到流程执行完

 

6.查询流程状态

/**     * 功能: 查询流程状态（判断流程正在执行，还是结束）.<br/>     * date: 2014年12月22日 下午3:52:22 <br/>     *      * @author [e-mail]     */    @Test    public void isProcessEnd() {        String processInstanceId = "1201";        ProcessInstance pi = processEngine.getRuntimeService()// 正在执行的流程实例和执行对象相关Service                .createProcessInstanceQuery() // 创建流程实例查询                .processInstanceId(processInstanceId) // 使用流程实例ID查询                .singleResult();        if (null == pi) {            System.out.println("流程已经结束！");        } else {            System.out.println("流程正在执行！");        }    }

在流程执行的过程中，创建的流程实例ID在整个过程中都不会变，当流程结束后，流程实例将会在正在执行的执行对象表中（act_ru_execution）被删除

 

说明：

       1）因为是查询流程实例，所以先获取runtimeService

       2）创建流程实例查询对象，设置实例ID过滤参数

       3）由于一个流程实例ID只对应一个实例，使用singleResult执行查询返回一个唯一的结果，如果结果数量大于1，则抛出异常

       4）判断指定ID的实例是否存在，如果结果为空，则代表流程结束，实例在正在执行的执行对象表中已被删除，转换成历史数据

 
7.查询历史任务 

/**     * 功能: 查询历史任务.<br/>     * date: 2014年12月22日 下午4:15:55 <br/>     *      * @author [e-mail]     */    @Test    public void findHistoryTask() {        String taskAssignee = "张三";        List<HistoricTaskInstance> list = processEngine.getHistoryService()// 与历史数据相关的Service                .createHistoricTaskInstanceQuery() // 创建历史任务实例查询                .taskAssignee(taskAssignee) // 指定办理人                .list();        if (null != list && list.size() > 0) {            for (HistoricTaskInstance hist : list) {                System.out.println(hist.getId() + "   " + hist.getName() + "   " + hist.getProcessInstanceId() + "   "                                   + hist.getStartTime());                System.out.println("#########################");            }        }    }

 

8.查询历史流程实例 

/**     * 功能: 查询历史流程实例.<br/>     * date: 2014年12月22日 下午4:25:13 <br/>     *      * @author [e-mail]     */    @Test    public void findHistoryProcessInstance() {        String processInstanceId = "1201";        HistoricProcessInstance hpi = processEngine.getHistoryService()// 与历史数据相关的Service                .createHistoricProcessInstanceQuery() // 创建历史流程实例查询                .processInstanceId(processInstanceId) // 使用流程实例Id查询                .singleResult();        System.out.println(hpi.getId() + "    " + hpi.getProcessDefinitionId() + "   " + hpi.getStartTime() + "   "                           + hpi.getEndTime());    }

总结：

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：已经执行完的历史任务信息