Activiti入门案例
一、流程定义
Activiti-Designer 使用
Palette（画板）
在eclipse 或 idea 中安装activiti-designer 插件即可使用，画板中包括以下结点：
Connection—连接Event---事件Task---任务Gateway---网关Container—容器
Boundary event—边界事件Intermediate event- -中间事件
流程图设计完毕保存生成.bpmn 文件。
1、新建流程(IDEA 工具)
首先选中存放图形的目录(本次我们选择resources 下的bpmn 目录)，点击菜单：New-BpmnFile，如下图所示：
2、创建hoilday.bpmn，绘制流程
3、生成流程图
①首先将.bpmn文件改为.xml文件
②然后右键该xml文件Diagrams--->show BPMN 2.0 Designer就能生成一张流程图，将流程图导出保存到项目对应目录即可
③然后将.xml改回.bpmn即可
注意：
流程图生成前须设置编码格式然后重启IDEA！！！
-Dfile.encoding=UTF-8
二、部署流程定义
部署流程定义就是要将上边绘制的图形即流程定义（.bpmn）部署在工作流引擎activiti中
1、使用ProcessEngine创建RepositoryService
package com.zn;
import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.RepositoryService;
import org.activiti.engine.repository.Deployment;
import org.junit.Test;
public class ActivitiTest {
/*流程部署
* `act_ge_bytearray` 流程定义的资源信息，包含bpmn和png流程文件信息
* `act_re_deployment` 流程部署信息 包含流程名称，ID，key等
* `act_re_procdef` 流程定义信息
* */
@Test
public void deployment(){
//获取ProcessEngine对象 默认配置文件名称：activiti.cfg.xml 并且configuration的Bean实例ID为processEngineConfiguration
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
//获取RepositoryService对象进行流程部署
RepositoryService repositoryService = processEngine.getRepositoryService();
//进行部署,将对应的流程定义文件生成到数据库当中，作为记录进行保存
Deployment deployment = repositoryService.createDeployment()
//加载流程文件
.addClasspathResource("bpmnFiles/holiday.bpmn")
.addClasspathResource("bpmnFiles/holiday.png")
//设置流程名称
.name("请假流程")
.key("holidayKey")
//部署
.deploy();
//输出部署信息
System.out.println("流程名称："+deployment.getName());
System.out.println("流程ID："+deployment.getId());
System.out.println("流程Key："+deployment.getKey());
}
}
2、执行操作控制台效果
3、数据库展示
执行操作后activiti会将上边代码中执行的bpmn文件和图片文件保存在activiti数据库中；
三、启动一个流程实例
流程定义部署在activiti后就可以通过工作流管理业务流程了，也就是说上边部署的请假申请流程可以使用了；
针对该流程，启动一个流程表示发起一个新的请假申请单，这就相当于java类与java对象的关系，类定义好后需要new创建一个对象使用，当然可以new多个对象；对于请假申请流程，张三发起一个请假申请需要启动一个流程实例，请假申请单发起一个请假单也需要启动一个流程实例；
1、代码实现
package com.zn;
import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.RepositoryService;
import org.activiti.engine.RuntimeService;
import org.activiti.engine.repository.Deployment;
import org.activiti.engine.runtime.ProcessInstance;
import org.junit.Test;
public class ActivitiTest {
/**
* 启动流程实例
* `act_hi_actinst` 已开始和执行完毕的活动信息
* `act_hi_identitylink` 历史参与者信息
* `act_hi_procinst` 流程实例信息
* `act_hi_taskinst` 历史任务实例
* act_ru_execution 任务执行信息
* act_ru_identitylink 当前任务参与者
* `act_ru_task` 任务信息
*
*/
@Test
public void startInstance(){
//获取ProcessEngine对象 默认配置文件名称：activiti.cfg.xml 并且configuration的Bean实例ID为processEngineConfiguration
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
//获取到RuntimeService对象
RuntimeService runtimeService = processEngine.getRuntimeService();
//创建流程实例
ProcessInstance holiday = runtimeService.startProcessInstanceByKey("holiday");
//输出实例信息
System.out.println("流程部署ID："+holiday.getDeploymentId());
System.out.println("流程实例ID："+holiday.getId());
System.out.println("活动ID："+holiday.getActivityId());
}
}
2、执行操作控制台效果
3、数据库展示
四、任务查询
流程启动后，各个任务的负责人就可以查看自己当前需要处理的任务，查询出来的任务都是该用户的代办任务；
1、代码实现
package com.zn;
import org.activiti.engine.*;
import org.activiti.engine.history.HistoricActivityInstance;
import org.activiti.engine.history.HistoricActivityInstanceQuery;
import org.activiti.engine.repository.Deployment;
import org.activiti.engine.runtime.ProcessInstance;
import org.activiti.engine.task.Task;
import org.junit.Test;
import java.util.List;
public class ActivitiTest {
/**
* 查看代办任务
*/
@Test
public void getTask(){
//获取ProcessEngine对象 默认配置文件名称：activiti.cfg.xml 并且configuration的Bean实例ID为processEngineConfiguration
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
//获取一个TaskService对象
TaskService taskService=processEngine.getTaskService();
//查询代办业务 createTaskQuery查询任务 taskCandidateOrAssigned查询任务执行者 processDefinitionKey：查询流程
/**
* taskCandidateOrAssigned匹配规则:1.Assigned 2.配置bpmn文件中定义的值
* taskAssignee匹配规则:1.Assigned
*/
//List<Task> list=taskService.createTaskQuery().taskCandidateOrAssigned("zhangsan").processDefinitionKey("holiday").list();
//taskAssignee查看当前指定人的指定任务
List<Task> list = taskService.createTaskQuery().taskAssignee("lisi").processDefinitionKey("holiday").list();
//分页：List<Task> list = taskService.createTaskQuery().taskAssignee("zhangsan").processDefinitionKey("holiday").listPage(i,j);
for (Task task:list){
System.out.println("任务名称："+task.getName());
System.out.println("任务执行人："+task.getAssignee());
System.out.println("任务ID:"+task.getId());
System.out.println("流程实例ID："+task.getProcessInstanceId());
}
}
}
2、执行操作控制台效果
3、数据库
五、任务处理
任务负责人查询代办任务，选择任务进行处理，完成任务；
1、代码实现
package com.zn;
import org.activiti.engine.*;
import org.activiti.engine.repository.Deployment;
import org.activiti.engine.runtime.ProcessInstance;
import org.activiti.engine.task.Task;
import org.junit.Test;
import java.util.List;
public class ActivitiTest {
/*任务处理
* `act_hi_identitylink` 历史参与者信息
* `act_hi_taskinst` 历史任务信息
* `act_ru_execution` 任务执行信息
* `act_ru_task` 任务信息
* 当所有任务处理完毕，对应当前流程实例信息删除，但是可以在历史中查看该信息
* */
@Test
public void completeTask(){
//获取ProcessEngine对象 默认配置文件名称：activiti.cfg.xml 并且configuration的Bean实例ID为processEngineConfiguration
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
//获取一个TaskService对象
TaskService taskService = processEngine.getTaskService();
//任务处理
taskService.complete("35005");
}
}
2、执行操作控制台效果
3、数据库展示
4、任务查询（经理审批）控制台效果
5、任务处理（经理审批）后数据库显示
6、任务查询（总经理审批）控制台效果
7、再次任务处理（总经理审批）后数据库显示
8、任务查询（人事审批）控制台效果
9、再次任务处理（人事审批）后数据库显示
10、至此流程结束
六、查看历史任务
1、代码实现
package com.zn;
import org.activiti.engine.*;
import org.activiti.engine.history.HistoricActivityInstance;
import org.activiti.engine.history.HistoricActivityInstanceQuery;
import org.activiti.engine.repository.Deployment;
import org.activiti.engine.runtime.ProcessInstance;
import org.activiti.engine.task.Task;
import org.junit.Test;
import java.util.List;
public class ActivitiTest {
/**
* 查看历史任务
*/
@Test
public void getHistory() {
//获取ProcessEngine对象 默认配置文件名称：activiti.cfg.xml 并且configuration的Bean实例ID为processEngineConfiguration
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
//获取HistoryService接口
HistoryService historyService = processEngine.getHistoryService();
//获取历史任务
HistoricActivityInstanceQuery historicActivityInstanceQuery = historyService.createHistoricActivityInstanceQuery();
//获取指定流程实例的任务
historicActivityInstanceQuery.processInstanceId("35001");
//获取任务列表
List<HistoricActivityInstance> list = historicActivityInstanceQuery.list();
for (HistoricActivityInstance ai : list) {
System.out.println("任务节点ID："+ai.getActivityId());
System.out.println("任务节点名称："+ai.getActivityName());
System.out.println("流程实例ID信息："+ai.getProcessDefinitionId());
System.out.println("流程实例ID信息："+ai.getProcessInstanceId());
System.out.println("==============================");
}
}
}
2、控制台效果
