最近公司在做一个带审核流程的功能,部门leader指出要集成activiti流程,而且后续的需求里也会用到。之前没有接触过经过查阅资料,自己尝试,最终走完了整个流程,记录一下自己的学习过程,如有不足之处,欢迎指正

简介:

Activiti是一个项目的名称，Alfresco软件在2010年5月17日宣布Activiti业务流程管理（BPM）开源项目的正式启动，其首席架构师由业务流程管理BPM的专家 Tom Baeyens担任。

Activiti项目是一项新的基于Apache许可的开源BPM平台，从基础开始构建，旨在提供支持新的BPMN 2.0标准，包括支持对象管理组（OMG），面对新技术的机遇，诸如互操作性和云架构，提供技术实现。

创始人Tom Baeyens是JBoss jBPM的项目架构师，以及另一位架构师Joram Barrez，一起加入到创建Alfresco这项首次实现Apache开源许可的BPMN 2.0引擎开发中来。

Activiti是一个独立运作和经营的开源项目品牌，并将独立于Alfresco开源ECM系统运行。 Activiti将是一种轻量级，可嵌入的BPM引擎，而且还设计适用于可扩展的云架构。 Activiti将提供宽松的Apache许可2.0，以便这个项目可以广泛被使用，同时促进Activiti BPM引擎和的BPMN 2.0的匹配，该项目现正由OMG通过标准审定。
 

首先安装一个插件

pom依赖

<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter</artifactId>
		</dependency>

		<!--添加Activiti工作流的支持 一般需要exclusions -->
		<dependency>
			<groupId>org.activiti</groupId>
			<artifactId>activiti-engine</artifactId>
			<version>5.21.0</version>
		</dependency>
		<!--添加Activiti工作流对Spring的支持-->
		<dependency>
			<groupId>org.activiti</groupId>
			<artifactId>activiti-spring</artifactId>
			<version>5.21.0</version>
		</dependency>

		<dependency>
			<groupId>org.activiti</groupId>
			<artifactId>activiti-bpmn-model</artifactId>
			<version>5.21.0</version>
		</dependency>

		<dependency>
			<groupId>mysql</groupId>
			<artifactId>mysql-connector-java</artifactId>
			<version>5.1.38</version>
		</dependency>

		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
		</dependency>

		<dependency>
			<groupId>junit</groupId>
			<artifactId>junit</artifactId>
			<version>4.12</version>
		</dependency>
	</dependencies>

在resource下新建文件夹process,new一个bpmn文件

弄个简单流程图

整个流程的属性

各环节的属性

bpmn文件可能会乱码,解决办法:找到idea的安装目录,bin文件夹下两个文件用notepad编辑,在最后加上 -Dfile.encoding=UTF-8

在resource下新建配置文件activiti.cfg.xml,配置文件的名字必须是activiti.cfg.xml,因为源码当中有一个init的方法，里面他会自动去加载配置文件

配置文件内容

<?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="processEngineConfiguration"
          class="org.activiti.engine.impl.cfg.StandaloneInMemProcessEngineConfiguration">

        <property name="databaseSchemaUpdate" value="true"/>
        <property name="jdbcUrl" value="jdbc:mysql://localhost/activiti_demo?useSSL=false"/>
        <property name="jdbcDriver" value="com.mysql.jdbc.Driver"/>
        <property name="jdbcUsername" value="root"/>
        <property name="jdbcPassword" value="root"/>
        <!-- Databaseconfigurations -->

        <!--<property name="databaseSchemaUpdate" value="true" />-->

        <!-- jobexecutor configurations -->

        <!--<property name="jobExecutorActivate" value="false" />-->
    </bean>

</beans>

新建一个数据库activiti_demo,相关的表会自动创建

/**
     * 部署
     */
    @Test
    public void deploy() {
        //得到流程引擎的方式三，利用底层封装，来加载配置文件，只需要调用方法即可
        ProcessEngine pec = ProcessEngines.getDefaultProcessEngine();

        //部署的服务对象
        RepositoryService repositoryService = pec.getRepositoryService();

        //部署请假任务
        Deployment deploy = repositoryService.createDeployment()
                .addClasspathResource("process/leave.bpmn")
                .name("请假")
                .deploy();
        
        System.out.println("请假部署ID：" + deploy.getId());
    }

输出结果

刷新数据库表

数据库表
Activiti的后台是有数据库的支持，所有的表都以ACT_开头。 第二部分是表示表的用途的两个字母标识。用途也和服务的API对应。

  act_re_*: 'RE’表示repository。 这个前缀的表包含了流程定义和流程静态资源（图片，规则，等等）。

  act_ru_*: 'RU’表示runtime。 这些运行时的表，包含流程实例，任务，变量，异步任务，等运行中的数据。 Activiti只在流程实例执行过程中保存这些数据，在流程结束时就会删除这些记录。 这样运行时表可以一直很小速度很快。

  act_id_*: 'ID’表示identity。 这些表包含身份信息，比如用户，组等等。

  act_hi_*: 'HI’表示history。 这些表包含历史数据，比如历史流程实例，变量，任务等等。

  act_ge_*: 通用数据，用于不同场景下，如存放资源文件。

资源库流程规则表
1.act_re_deployment 部署信息表

2.act_re_model 流程设计模型部署表

3.act_re_procdef 流程定义数据表

运行时数据库表
1.act_ru_execution 运行时流程执行实例表

2.act_ru_identitylink 运行时流程人员表，主要存储任务节点与参与者的相关信息

3.act_ru_task 运行时任务节点表

4.act_ru_variable 运行时流程变量数据表

历史数据库表
1.act_hi_actinst 历史节点表

2.act_hi_attachment 历史附件表

3.act_hi_comment 历史意见表

4.act_hi_identitylink 历史流程人员表

5.act_hi_detail 历史详情表，提供历史变量的查询

6.act_hi_procinst 历史流程实例表

7.act_hi_taskinst 历史任务实例表

8.act_hi_varinst 历史变量表

组织机构表
1.act_id_group 用户组信息表

2.act_id_info 用户扩展信息表

3.act_id_membership 用户与用户组对应信息表

4.act_id_user 用户信息表

这四张表很常见，基本的组织机构管理，关于用户认证方面建议还是自己开发一套，组件自带的功能太简单，使用中有很多需求难以满足

通用数据表
act_ge_bytearray 二进制数据表

act_ge_property 属性数据表存储整个流程引擎级别的数据,初始化表结构时，会默认插入三条记录

查看act_re_procdef流程定义数据表

可以看到我们部署的任务，它的key是myProcess_1，也就是我们之前画图时整个流程的ID

查看act_re_deployment 部署信息表,可以看到部署的任务

查看act_ge_bytearray 二进制数据表,可以看到我们传到数据库的的资源包括生成的png的图片都在这里

/**
     * 开始任务
     */
    @Test
    public void start() {
        //根据流程引擎对象得到运行时服务对象
        ProcessEngine defaultProcessEngine = ProcessEngines.getDefaultProcessEngine();
        RuntimeService runtimeService = defaultProcessEngine.getRuntimeService();
        //根据key得到流程实例
        ProcessInstance myProcess1 = runtimeService.startProcessInstanceByKey("myProcess_1");
        //输出运行时流程实例id以及我们启动的流程它的一个定义id
        System.out.println("流程实例id：" + myProcess1.getId());
        System.out.println("流程定义ID:" + myProcess1.getProcessDefinitionId());
    }

运行结果

查看act_ru_task 运行时任务节点表

可以看见我们刚开始的一个任务，就是请假，它的EXECUTION_ID_是2501，而这条任务的id是2504,然后执行的任务name是请假，请假人是ASSIGNEE_员工

/**
     * 完成任务
     */
    @Test
    public void complete() {
        ProcessEngine defaultProcessEngine = ProcessEngines.getDefaultProcessEngine();
        TaskService taskService = defaultProcessEngine.getTaskService();
        //根据ID完成任务
        taskService.complete("2504");
    }

刷新act_ru_task表

由于请假任务的完成审批任务就自动被触发了，所以我们不需要再去启动审批任务，而是由框架自动触发

查看act_hi_actinst 历史节点表

可以看下startTime和endTime,startEvent结束的同时员工请假任务开始,员工完成请假的时间就是审批任务开始的时间,而在我们没有完成审批任务之前,我们的审批任务是没有结束时间的,因为这个时候它还是待处理此状态

接着根据审批任务的id完成审批任务

/**
     * 完成任务
     */
    @Test
    public void complete() {
        ProcessEngine defaultProcessEngine = ProcessEngines.getDefaultProcessEngine();
        TaskService taskService = defaultProcessEngine.getTaskService();
        //根据ID完成任务
        taskService.complete("5002");
    }

刷新act_ru_task表

空空如也,我们的审批任务也完成了；

在这里我们就会发现一个流程框架的机制：

那就是：当一个任务被开始的时候，它会出现在我们的运行时任务当中，当这个任务完成了，这个任务的记录就会出现在我们的历史记录表当中，而这时运行时任务表时空的，简单的说，其时运行时的几张表充当的就是相当于电脑内存的作用，做个类比它们就是流程框架的内存

查看act_hi_actinst 历史节点表

至此,一个简单的流程就走完了,还需结合实际业务需求进行调整

参考文章