Activiti使用
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文件需要的依赖
- 单机版
4.0.0
org.example
ActivitiDemo
1.0-SNAPSHOT
org.activiti
activiti-engine
7.0.0.Beta1
org.activiti
activiti-spring
7.0.0.Beta1
org.activiti
activiti-bpmn-converter
7.0.0.Beta1
org.activiti
activiti-bpmn-model
7.0.0.Beta1
org.activiti
activiti-json-converter
7.0.0.Beta1
org.activiti
activiti-bpmn-layout
7.0.0.Beta1
org.activiti.cloud
activiti-cloud-services-api
7.0.0.Beta1
mysql
mysql-connector-java
8.0.15
junit
junit
4.12
test
log4j
log4j
1.2.12
org.slf4j
slf4j-api
1.7.25
org.slf4j
slf4j-log4j12
1.7.25
test
org.mybatis
mybatis
3.4.6
commons-dbcp
commons-dbcp
1.4
org.projectlombok
lombok
1.16.18
true
alfresco
Activiti Releases
https://artifacts.alfresco.com/nexus/content/repositories/activiti-releases/
true
- 整合springboot版
ActivitiWebDemo
org.example
1.0-SNAPSHOT
4.0.0
ActivitiWeb
jar
org.springframework.boot
spring-boot-starter-web
org.springframework.boot
spring-boot-devtools
runtime
true
org.projectlombok
lombok
true
org.springframework.boot
spring-boot-starter-test
test
com.alibaba
fastjson
1.2.62
mysql
mysql-connector-java
org.springframework.boot
spring-boot-starter-jdbc
org.activiti
activiti-spring-boot-starter-basic
6.0.0
org.springframework.boot
spring-boot-maven-plugin
2.2.6.RELEASE
repackage
下面针对单机版进行讲解，方便理解
我们需要在resources下创建activiti.cfg.xml配置文件，方便工程启动读取activiti配置信息
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 map = new HashMap();
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 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 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 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("-------");
}
}
}