Activiti（八）：流程实例、任务的执行

原文链接

1、部署流程定义

[java]  view plain  copy

1. ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();  
2.   
3. /**1.部署流程定义（从zip）*/  
4. @Test  
5. public void deploymentProcessDefinition_zip(){  
6.     InputStream in = this.getClass().getClassLoader().getResourceAsStream("diagrams/helloworld.zip");  
7.     ZipInputStream zipInputStream = new ZipInputStream(in);  
8.     Deployment deployment = processEngine.getRepositoryService()//与流程定义和部署对象相关的Service  
9.                     .createDeployment()//创建一个部署对象  
10.                     .name("请假流程")//添加部署的名称  
11.                     .addZipInputStream(zipInputStream)//指定zip格式的文件完成部署  
12.                     .deploy();//完成部署  
13.     System.out.println("部署ID："+deployment.getId());//  
14.     System.out.println("部署名称："+deployment.getName());//  
15. }     

部署ID：801     部署名称：请假流程

2、启动流程实例

[java]  view plain  copy

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

流程实例ID:901     流程定义ID:helloworld:5:804

说明：
   1).操作数据库的act_ru_execution表,如果是用户任务节点，同时也会在act_ru_task添加一条记录
   2).一个流程实例只有一个，执行对象可以存在多个

3、查询我的个人任务

[java]  view plain  copy

1.     /**3.查询当前人的个人任务*/  
2.     @Test  
3.     public void findMyPersonalTask(){  
4.         String assignee = "张三";  
5.         List<Task> list = processEngine.getTaskService()//与正在执行的任务管理相关的Service  
6.                         .createTaskQuery()//创建任务查询对象  
7.                         /**查询条件（where部分）*/  
8.                         .taskAssignee(assignee)//指定个人任务查询，指定办理人  
9. //                      .taskCandidateUser(candidateUser)//组任务的办理人查询  
10. //                      .processDefinitionId(processDefinitionId)//使用流程定义ID查询  
11. //                      .processInstanceId(processInstanceId)//使用流程实例ID查询  
12. //                      .executionId(executionId)//使用执行对象ID查询  
13.                         /**排序*/  
14.                         .orderByTaskCreateTime().asc()//使用创建时间的升序排列  
15.                         /**返回结果集*/  
16. //                      .singleResult()//返回惟一结果集  
17. //                      .count()//返回结果集的数量  
18. //                      .listPage(firstResult, maxResults);//分页查询  
19.                         .list();//返回列表  
20.         if(list!=null && list.size()>0){  
21.             for(Task task:list){  
22.                 System.out.println("任务ID:"+task.getId());  
23.                 System.out.println("任务名称:"+task.getName());  
24.                 System.out.println("任务的创建时间:"+task.getCreateTime());  
25.                 System.out.println("任务的办理人:"+task.getAssignee());  
26.                 System.out.println("流程实例ID："+task.getProcessInstanceId());  
27.                 System.out.println("执行对象ID:"+task.getExecutionId());  
28.                 System.out.println("流程定义ID:"+task.getProcessDefinitionId());  
29.                 System.out.println("########################################################");  
30.             }  
31.         }  
32.     }  

任务ID:904 任务名称:提交申请 任务的创建时间:Sat Sep 10 12:38:48 CST 2016 任务的办理人:张三 流程实例ID：901 执行对象ID:901 流程定义ID:helloworld:5:804 ########################################################

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

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

4、办理任务

[java]  view plain  copy

1. /**完成我的任务*/  
2. @Test  
3. public void completeMyPersonalTask(){  
4.     //任务ID  
5.     String taskId = "904";  
6.     processEngine.getTaskService()//与正在执行的任务管理相关的Service  
7.                 .complete(taskId);  
8.     System.out.println("完成任务：任务ID："+taskId);  
9. }  

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

扫描二维码关注公众号，回复： 1556137 查看本文章

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

[java]  view plain  copy

1. /**查询流程状态（判断流程正在执行，还是结束）*/  
2. @Test  
3. public void isProcessEnd(){  
4.     String processInstanceId = "1001";  
5.     ProcessInstance pi = processEngine.getRuntimeService()//表示正在执行的流程实例和执行对象  
6.                     .createProcessInstanceQuery()//创建流程实例查询  
7.                     .processInstanceId(processInstanceId)//使用流程实例ID查询  
8.                     .singleResult();  
9.     if(pi==null){  
10.         System.out.println("流程已经结束");  
11.     }  
12.     else{  
13.         System.out.println("流程没有结束");  
14.     }  
15. }  

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

6、附加功能：查询历史任务（后面讲）

[java]  view plain  copy

1. /**查询历史任务（后面讲）*/  
2. @Test  
3. public void findHistoryTask(){  
4.     String taskAssignee = "张三";  
5.     List<HistoricTaskInstance> list = processEngine.getHistoryService()//与历史数据（历史表）相关的Service  
6.                     .createHistoricTaskInstanceQuery()//创建历史任务实例查询  
7.                     .taskAssignee(taskAssignee)//指定历史任务的办理人  
8.                     .list();  
9.     if(list!=null && list.size()>0){  
10.         for(HistoricTaskInstance hti:list){  
11.             System.out.println(hti.getId()+"    "+hti.getName()+"    "+hti.getProcessInstanceId()+"   "+hti.getStartTime()+"   "+hti.getEndTime()+"   "+hti.getDurationInMillis());  
12.             System.out.println("################################");  
13.         }  
14.     }  
15. }  

7、附加功能：查询历史流程实例（后面讲）

[java]  view plain  copy

1. /**查询历史流程实例（后面讲）*/  
2. @Test  
3. public void findHistoryProcessInstance(){  
4.     String processInstanceId = "1001";  
5.     HistoricProcessInstance hpi = processEngine.getHistoryService()//与历史数据（历史表）相关的Service  
6.                     .createHistoricProcessInstanceQuery()//创建历史流程实例查询  
7.                     .processInstanceId(processInstanceId)//使用流程实例ID查询  
8.                     .singleResult();  
9.     System.out.println(hpi.getId()+"    "+hpi.getProcessDefinitionId()+"    "+hpi.getStartTime()+"    "+hpi.getEndTime()+"     "+hpi.getDurationInMillis());  
10. }