Activiti作用(代码见附件)
activiti就是一个工作审批流,请假,报销,采购申请等等,我们需要提交申请,然后有经理审批,审批过后交由人事备案。。。等等。这一系列的流程,就是activiti要操作的
Activiti核心思想
像刚刚说到的流程,自己在使用代码也可以完成,那为什么需要Activiti呢。
我们通常自己开发时候,需要创建数据库,然后使用一个字段status表示当前的执行的状态,然后通过更改状态去推动流程的进行,同时保存历史流程。等等相同概念的操作。
这样以来,我们写的代码流程是死的,是永远不会变动的,一旦流程更改,就要去改相应的代码才能实现更改流程。
Activiti也是使用数据库来组织流程的推进和记录。但是他可以在不更改代码的情况下去改变流程的进行,这也就是他的最大优点。后面会讲到Activiti是怎么实现不改变代码而改变流程
上面说到Activiti也是通过数据库操作去推进流程的,这里以Activiti7作为参考。Activiti在运行时候会创建25张表。里面保存了我们定义的流程,流程的实例,当前执行到的步骤,历史信息,常用属性等等。
Activiti核心思想就是利用上面的25张表。
- 初始化时候读区流程定义的文件,放到数据库中,这样就保存了全部的流程。更改流程也只需要更改流程定义文件就可以改变流程。
- 流程写入数据库后,我们创建一个流程,会读区流程文件,同时创建一条记录,这条记录只是流程中的一步,而不是全部流程!同时历史记录表中会记录这一步,记录的只有开始时间,没有完成时间。
- 在执行到下一步时候会删除这条记录而去创建下一步记录。这样就可以保证一个流程始终只有一步在运行。并且,流程文件更改时候可以直接更改流程,因为每次只从流程定义文件读取一条步骤。同时,历史记录中的记录会填写上完成时间。
- 执行下一步时候,会重复上面操作。直到结束。
从上面可以看出,Activiti的流程操作都是这25张表来实现的。里面包含了流程定义,创建的流程实例,流程实例执行到的步骤,流程实例执行的历史记录,常用属性等等。下面介绍这25张表
Activiti流程定义文件
Activiti一套完整的方便的业务流程管理(BPM)框架,这里bpmn到底上啥就不多介绍了,百度官方定义多了去。我们不关心它啥啥啥,只关心怎么用。它是覆盖了业务流程管理、工作流、服务协作等领域的一个开源的、灵活的、易扩展的可执行流程语言框架。开发人员可以通过插件直接绘画出业务。
这里使用IDEA,画流程图插件:actiBPM(在IDEA插件管理中安装就可以了)。Eclipse可以自行百度哈。按照流程也可以百度,也就是idea->setting->plugins->actiBPM安装就好了。
我们可以创建一个空的maven项目,方便后面加入依赖。在刚刚创建的空maven项目中resource文件新建processes文件夹,在右击新建Bpmnfile文件,如下图。
打开文件如下图就可以绘制工作流程了,这里我绘制了下图的流程。对于新手可能看不懂。你们可以简化
- 左侧节点属性,注意Assigine流程执行人可以直接写名字,也可以使用${t1}占位去后面流程创建时候指定
- 左侧节点属性,Candidate Users执行人组,可以指定多个执行人任选一个拾取任务去执行,一个执行人拾取任务后其他执行人便不能在拾取了
- 点击画布,第一个是属性id,是流程定义的id,非常重要
- 点击画布,第二个属性是name,是流程的名称
- 其他节点,使用等等自行百度哈。
流程绘制完成后,便可以得到一个bpmn文件了,我们可以copy一份将后缀名改为XML,查看下内容,就发现bpmn其实就是一个xml我文件,只是idea通过actiBPM插件给解析成我们看到的画面的。
右击刚刚的xml文件->选择diagrams->选择show BPMN2.0 Designer,就可以看到流程样子了,可以在上面按钮中保存成png图片文件,留后面使用,记得将生产的png文化copy到与bpmn相同目录下哈。
Activii表介绍
表名默认以“ACT_”开头,并且表名的第二部分用两个字母表明表的用例,而这个用例也基本上跟Service API匹配。
ACT_GE_* : “GE”代表“General”(通用),用在各种情况下;
ACT_HI_* : “HI”代表“History”(历史),这些表中保存的都是历史数据,比如执行过的流程实例、变量、任务,等等。Activit默认提供了4种历史级别:
ACT_ID_* : “ID”代表“Identity”(身份),这些表中保存的都是身份信息,如用户和组以及两者之间的关系。如果Activiti被集成在某一系统当中的话,这些表可以不用,可以直接使用现有系统中的用户或组信息;
ACT_RE_* : “RE”代表“Repository”(仓库),这些表中保存一些‘静态’信息,如流程定义和流程资源(如图片、规则等);
ACT_RU_* : “RU”代表“Runtime”(运行时),这些表中保存一些流程实例、用户任务、变量等的运行时数据。Activiti只保存流程实例在执行过程中的运行时数据,并且当流程结束后会立即移除这些数据,这是为了保证运行时表尽量的小并运行的足够快;
参考这篇文章可以看到详细说明
Activiti简单实用
首先就是activiti中maven的pom文件需要的依赖
- 单机版
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>org.example</groupId>
<artifactId>ActivitiDemo</artifactId>
<version>1.0-SNAPSHOT</version>
<dependencies>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-engine</artifactId>
<version>7.0.0.Beta1</version>
</dependency>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-spring</artifactId>
<version>7.0.0.Beta1</version>
</dependency>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-bpmn-converter</artifactId>
<version>7.0.0.Beta1</version>
</dependency>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-bpmn-model</artifactId>
<version>7.0.0.Beta1</version>
</dependency>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-json-converter</artifactId>
<version>7.0.0.Beta1</version>
</dependency>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-bpmn-layout</artifactId>
<version>7.0.0.Beta1</version>
</dependency>
<dependency>
<groupId>org.activiti.cloud</groupId>
<artifactId>activiti-cloud-services-api</artifactId>
<version>7.0.0.Beta1</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.15</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.12</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.25</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
<version>1.7.25</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.4.6</version>
</dependency>
<dependency>
<groupId>commons-dbcp</groupId>
<artifactId>commons-dbcp</artifactId>
<version>1.4</version>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.16.18</version>
<optional>true</optional>
</dependency>
</dependencies>
<repositories>
<repository>
<id>alfresco</id>
<name>Activiti Releases</name>
<url>https://artifacts.alfresco.com/nexus/content/repositories/activiti-releases/</url>
<releases>
<enabled>true</enabled>
</releases>
</repository>
</repositories>
</project>
- 整合springboot版
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<!-- 这里我是父子工程,可以引入Springboot自己的父pom -->
<parent>
<artifactId>ActivitiWebDemo</artifactId>
<groupId>org.example</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>ActivitiWeb</artifactId>
<packaging>jar</packaging>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<scope>runtime</scope>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<!-- https://mvnrepository.com/artifact/com.alibaba/fastjson -->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.2.62</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-spring-boot-starter-basic</artifactId>
<version>6.0.0</version>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<version>2.2.6.RELEASE</version>
<executions>
<execution>
<goals>
<goal>repackage</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
下面针对单机版进行讲解,方便理解
我们需要在resources下创建activiti.cfg.xml配置文件,方便工程启动读取activiti配置信息
<?xml version="1.0" encoding="utf-8" ?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">
<!--数据源-->
<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource">
<property name="driverClassName" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://127.0.0.1:3306/activitidemo"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</bean>
<!--配置Activiti使用的processEngine对象 默认命名为processEngineConfiguration-->
<bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
<!--注入数据源-->
<property name="dataSource" ref="dataSource"/>
<!--配置数据源方式二:-->
<!--<property name="jdbcDriver" value="com.mysql.jdbc.Driver"/>-->
<!--指定数据库生成策略-->
<property name="databaseSchemaUpdate" value="true"/>
</bean>
</beans>
log4j配置文件
# Set root category priority to INFO and its only appender to CONSOLE.
#log4j.rootCategory=INFO, CONSOLE debug info warn error fatal
log4j.rootCategory=debug, CONSOLE, LOGFILE
# Set the enterprise logger category to FATAL and its only appender to CONSOLE.
log4j.logger.org.apache.axis.enterprise=FATAL, CONSOLE
# CONSOLE is set to be a ConsoleAppender using a PatternLayout.
log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern=%d{ISO8601} %-6r [%15.15t] %-5p %30.30c %x - %m\n
# LOGFILE is set to be a File appender using a PatternLayout.
log4j.appender.LOGFILE=org.apache.log4j.FileAppender
log4j.appender.LOGFILE.File=/Users/luoyu/soft/software/ideawork/ActivitiDemo/log
log4j.appender.LOGFILE.Append=true
log4j.appender.LOGFILE.layout=org.apache.log4j.PatternLayout
log4j.appender.LOGFILE.layout.ConversionPattern=%d{ISO8601} %-6r [%15.15t] %-5p %30.30c %x - %m\n
全部配置就完成了,下面就可以简单的测试了,嗯。嗯。嗯。写累了直接上代码吧。
package www.luoyu.test;
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.repository.ProcessDefinition;
import org.activiti.engine.repository.ProcessDefinitionQuery;
import org.activiti.engine.runtime.ProcessInstance;
import org.activiti.engine.task.Task;
import org.junit.Test;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
public class TestActiviti {
/**
* 加载流程文件
*/
@Test
public void testGentable(){
// ProcessEngineConfiguration configuration = ProcessEngineConfiguration.createProcessEngineConfigurationFromResource("activiti.cfg.xml");
// ProcessEngine processEngine = configuration.buildProcessEngine();
// System.out.println(processEngine);
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
RepositoryService repositoryService = processEngine.getRepositoryService();
Deployment deployment = repositoryService.createDeployment()
.addClasspathResource("diagram/holiday.bpmn")
.addClasspathResource("diagram/holiday.png")
.name("请假流程测试")
.deploy();
System.out.println(deployment.getName());
System.out.println(deployment.getId());
}
/**
* 创建流程
*/
@Test
public void createProcess(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
RuntimeService runtimeService = processEngine.getRuntimeService();
Map<String,Object> map = new HashMap<String, Object>();
map.put("t1","zhangsan");
map.put("t2","lisi");
map.put("t3","wangwu");
ProcessInstance holiday = runtimeService.startProcessInstanceByKey("holiday","businessKey1", map);
}
/**
* 完成流程
*/
@Test
public void complelte(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
TaskService taskService = processEngine.getTaskService();
RuntimeService runtimeService = processEngine.getRuntimeService();
List<Task> taskList = taskService.createTaskQuery()
.processDefinitionKey("holiday2")
.taskAssignee("xiaofeng")
.list();
System.out.println("---------------------------------------");
for (Task task :taskList){
System.out.println(task.getProcessInstanceId());
// //拿到实例对象
// ProcessInstance processInstance = runtimeService.createProcessInstanceQuery()
// .processInstanceId(task.getProcessInstanceId())
// .singleResult();
// //拿到businessKey
// if (processInstance != null){
// String businessKey = processInstance.getBusinessKey();
// System.out.println(businessKey);
// }
taskService.complete(task.getId());
}
}
/**
* 历史数据
*/
@Test
public void history(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
HistoryService historyService = processEngine.getHistoryService();
HistoricActivityInstanceQuery historicActivityInstanceQuery = historyService.createHistoricActivityInstanceQuery();
List<HistoricActivityInstance> list = historicActivityInstanceQuery
.orderByHistoricActivityInstanceStartTime()
// .processInstanceId("2501")
.taskAssignee("zhangsan")
.finished()
.asc()
.list();
for (HistoricActivityInstance historicActivityInstance :list){
System.out.println(historicActivityInstance.getId());
System.out.println(historicActivityInstance.getProcessInstanceId());
System.out.println(historicActivityInstance.getActivityName());
}
}
/**
* 删除流程
*/
@Test
public void delete(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
RepositoryService repositoryService = processEngine.getRepositoryService();
repositoryService.deleteDeployment("17501",true);
}
/**
* 查询流程定义
*/
@Test
public void queryDefinition(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
RepositoryService repositoryService = processEngine.getRepositoryService();
ProcessDefinitionQuery processDefinitionQuery = repositoryService.createProcessDefinitionQuery();
List<ProcessDefinition> holiday = processDefinitionQuery
// .processDefinitionKey("holiday")
.orderByProcessDefinitionVersion()
.asc()
.list();
for (ProcessDefinition processDefinition :holiday){
System.out.println(processDefinition.getId());
System.out.println(processDefinition.getName());
System.out.println(processDefinition.getKey());
System.out.println(processDefinition.getVersion());
System.out.println(processDefinition.getDeploymentId());
System.out.println("-------");
}
}
}