最近项目中要用到工作流Activiti,刚好有时间可以学习下。这里记录我的学习成果。
概念啥的不说了,直接上干货。
首先在idea中找到actiBPM插件并安装。
接下来,新建一个SpringBoot项目,在pom中加入依赖(这里只列出来activiti的依赖,其他依赖自行添加)
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-spring</artifactId>
<version>6.0.0</version>
</dependency>
在yml文件中进行配置(自行配置数据库相关)
spring:
activiti:
check-process-definitions: true #自动检查、部署流程定义文件
database-schema-update: true #自动更新数据库结构
history-level: full #保存历史数据级别设置为full最高级别,便于历史数据的追溯
# process-definition-location-prefix: classpath:/processes/ #流程定义文件存放目录
#process-definition-location-suffixes: #流程文件格式
# - **.bpmn20.xml
# - **.bpmn
接下来编写一个配置类,让项目启动的时候自动扫描流程文件
@Configuration
public class ActivitiConfig {
private final static Logger log = LoggerFactory.getLogger(ActivitiConfig.class);
/*
* 配置分为以下几步骤
* 1. 创建ActivitiConfig
* 2. 使用ActivitiConfig创建ProcessEngineFactoryBean
* 3. 使用ProcessEngineFactoryBean创建ProcessEngine对象
* 4. 使用ProcessEngine对象创建需要的服务对象
* */
private Logger logger = LoggerFactory.getLogger(ActivitiConfig.class);
private final DataSource dataSource;
private final PlatformTransactionManager platformTransactionManager;
@Autowired
public ActivitiConfig(DataSource dataSource, PlatformTransactionManager platformTransactionManager) {
this.dataSource = dataSource;
this.platformTransactionManager = platformTransactionManager;
}
/*
*自动扫描process包下的bpmn(流程定义文件)的设置,这样就可以省去了部署
* */
@Bean
public SpringProcessEngineConfiguration springProcessEngineConfiguration() {
SpringProcessEngineConfiguration spec = new SpringProcessEngineConfiguration();
spec.setDataSource(dataSource);
spec.setTransactionManager(platformTransactionManager);
spec.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);
Resource[] resources = null;
// 启动自动部署流程
try {
//注意:下面那个路径是你resource文件夹下存放流程图的路径
resources = new PathMatchingResourcePatternResolver().getResources("classpath*:processes/*.bpmn");
} catch (IOException e) {
e.printStackTrace();
}
spec.setDeploymentResources(resources);
return spec;
}
@Bean
public ProcessEngineFactoryBean processEngine() {
ProcessEngineFactoryBean processEngineFactoryBean = new ProcessEngineFactoryBean();
processEngineFactoryBean.setProcessEngineConfiguration(springProcessEngineConfiguration());
return processEngineFactoryBean;
}
@Bean
public RepositoryService repositoryService() throws Exception {
return processEngine().getObject().getRepositoryService();
}
@Bean
public RuntimeService runtimeService() throws Exception {
return processEngine().getObject().getRuntimeService();
}
@Bean
public TaskService taskService() throws Exception {
return processEngine().getObject().getTaskService();
}
@Bean
public HistoryService historyService() throws Exception {
return processEngine().getObject().getHistoryService();
}
}
接着启动项目,启动完后,你会发现在数据库里面多了一些表
其中:
“GE”代表“General”(通用),用在各种情况下;
“HI”代表“History”(历史),这些表中保存的都是历史数据,Activit默认提供了4种历史级别:
none: 不保存任何历史记录,可以提高系统性能;
activity:保存所有的流程实例、任务、活动信息;
audit:也是Activiti的默认级别,保存所有的流程实例、任务、活动、表单属性;
full:最完整的历史记录,除了包含audit级别的信息之外还能保存详细,例如:流程变量。
之前我们设置的就是full
“ID”代表“Identity”(身份),这些表中保存的都是身份信息
“RE”代表“Repository”(仓库)
“RU”代表“Runtime”(运行时)
接着开始画图,这是我的一个小例子
代码如下:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:activiti="http://activiti.org/bpmn" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:dc="http://www.omg.org/spec/DD/20100524/DC" xmlns:di="http://www.omg.org/spec/DD/20100524/DI" xmlns:tns="http://www.activiti.org/testm1539766523202" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" expressionLanguage="http://www.w3.org/1999/XPath" id="m1539766523202" name="" targetNamespace="http://www.activiti.org/testm1539766523202" typeLanguage="http://www.w3.org/2001/XMLSchema">
<process id="leave1" isClosed="false" isExecutable="true" processType="None">
<startEvent id="_2" name="start"/>
<!--因为后面要用到这个参数,所以写成可变的,下面的代码也是一样的-->
<userTask activiti:assignee="${agent}" activiti:exclusive="true" id="_5" name="submit">
<documentation id="_5_D_1"><![CDATA[submit]]></documentation>
</userTask>
<endEvent id="_7" name="EndEvent"/>
<sequenceFlow id="_8" sourceRef="_2" targetRef="_5"/>
<userTask activiti:assignee="${agent}" activiti:exclusive="true" id="_17" name="approve">
<document