activiti 基础

最新推荐文章于 2025-08-08 11:12:28 发布

转载最新推荐文章于 2025-08-08 11:12:28 发布 · 88 阅读

文章标签：

#数据库 #开发工具 #runtime

一：activiti 入门

作者：fenng 商丘

工作流（Workflow)

就是业务过程的部分或整体在计算机应用环境下的自动化
主要解决的是“使在多个参与者之间按照某种定义的规则传递文档，信息或任务的过程自动进行，从而实现某个预期的业务目标，或者促使此目标的实现”

工作流管理系统（WFMS）

是一个软件系统，它完成工作量的定义和管理，并按照在系统中预先定义好的工作流规则进行工作流实例的执行。工作流管理系统不是企业的业务系统，而是为企业的业务系统的运行提供了一个软件的支撑环境

工作流管理系统的目标

管理工作的流程以确保工作在正确的时间被期望的人员所执行——在自动化进行的业务过程中插入人工的执行和干预

Activiti 介绍

Activiti5 是由 Alfresco 软件在 2010 年 5 月 17 日发布的业务流程管理（BPM）框架，它是覆盖了业务流程管理、工作流、服务协作等领域的一个开源的、灵活的、易扩展的可执行流程语言框架。Activiti 基于 Apache 许可的开源 BPM 平台，创始人 Tom Baeyens 是 JBoss jBPM 的项目架构师，它特色是提供了 eclipse 插件，开发人员可以通过插件直接绘画出业务

工作流引擎

ProcessEngine 对象，这是 Activiti 工作的核心。负责生成流程运行时的各种实例及数据、监控和管理流程的运行。

BPMN

业务流程建模与标注（Business Process Model and Notation，BPMN) ，描述流程的基本符号，包括这些图元如何组合成一个业务流程图（Business Process Diagram）

核心配置文件

```{bash}

activiti.cfg.xml

  1 xmlns:context="http://www.springframework.org/schema/context"xmlns:tx="http://www.springframework.org/schema/tx"
  2 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3 xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
  4 http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-2.5.xsd
  5 http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.0.xsd">
  6

看到这里不得不感叹一下 spring 的强大，整合了 java 半壁江山

数据库

初始化数据库
方法一：

  1 //创建工作流需要的数据库 
  2 @Test
  3 public void createTable(){
  4     ProcessEngineConfiguration configuration = ProcessEngineConfiguration.createStandaloneProcessEngineConfiguration();
  5     configuration.setJdbcDriver("com.mysql.jdbc.Driver");
  6     configuration.setJdbcUrl("jdbc:mysql://localhost:3306/activiti");
  7     configuration.setJdbcUsername("root");
  8     configuration.setJdbcPassword("12345678");
  9 
 10     /**
 11          public static final String DB_SCHEMA_UPDATE_FALSE = "false";不能自动创建表，需要表存在
 12           public static final String DB_SCHEMA_UPDATE_CREATE_DROP = "create-drop";先删除表再创建表
 13           public static final String DB_SCHEMA_UPDATE_TRUE = "true";如果表不存在，自动创建表
 14      */
 15     configuration.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);
 16     //工作流的核心对象，ProcessEnginee对象
 17     ProcessEngine processEngine = configuration.buildProcessEngine();
 18     System.out.println("processEngine:"+processEngine);
 19     }

方法二：由于方法一要有代码比较麻烦，所以有配置文件替代：
activiti.cfg.xml

  1 xmlns:context="http://www.springframework.org/schema/context" xmlns:tx="http://www.springframework.org/schema/tx"
  2 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3 xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
  4 http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-2.5.xsd
  5 http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.0.xsd">
  6 
  7 
  8 
  9

  1 /**使用配置文件创建工作流需要的23张表*/
  2 @Test
  3 public void createTable_2(){
  4 //        ProcessEngineConfiguration processEngineConfiguration = ProcessEngineConfiguration.createProcessEngineConfigurationFromResource("activiti.cfg.xml");
  5 //        //工作流的核心对象，ProcessEnginee对象
  6 //        ProcessEngine processEngine = processEngineConfiguration.buildProcessEngine();
  7 
  8     ProcessEngine processEngine = ProcessEngineConfiguration.createProcessEngineConfigurationFromResource("activiti.cfg.xml")    //
  9                                 .buildProcessEngine();
 10     System.out.println("processEngine:"+processEngine);
 11 }

Activiti 用来存放流程数据一共使用了 23 张表都是以 Act_ 开头的底层操作使用的 mybatis 操作

工作流 Activiti 的表是用来存储流程数据的而业务数据都需要用户自己创建和维护一定要让业务去关联流程才能关联工作流系统

API

流程引擎 ProcessEngine 对象
在 Activiti 中最核心的类，其他的类都是由他而来。由流程引擎 ProcessEngine 对象创建各个 Service, 这些 Service 是调用工作流 23 张表的服务

RepositoryService 管理流程定义

RuntimeService 执行管理，包括启动，推进，删除流程实例等操作

TaskService 任务管理

HistoryService 历史管理（执行完的数据的管理）
IdentityService 组织机构管理
FormService 一个可选服务，任务表单管理
ManagerService

流程的执行过程

  1 ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
  2 /**部署流程定义*/
  3 @Test
  4 public void deploymentProcessDefinition(){
  5 
  6     Deployment deployment = processEngine.getRepositoryService()//与流程定义和部署对象相关的Service
  7                     .createDeployment()//创建一个部署对象
  8                     .name("helloworld入门程序")//添加部署的名称
  9                     .addClasspathResource("diagrams/helloworld.bpmn")//从classpath的资源中加载，一次只能加载一个文件
 10                     .addClasspathResource("diagrams/helloworld.png")//从classpath的资源中加载，一次只能加载一个文件
 11                     .deploy();//完成部署
 12     System.out.println("部署ID："+deployment.getId());//1
 13     System.out.println("部署名称："+deployment.getName());//helloworld入门程序  
 14 }
 15 /**启动流程实例*/
 16 @Test
 17 public void startProcessInstance(){
 18     //流程定义的key
 19     String processDefinitionKey = "helloword";
 20     ProcessInstance pi = processEngine.getRuntimeService()//与正在执行的流程实例和执行对象相关的Service
 21                     .startProcessInstanceByKey(processDefinitionKey);//使用流程定义的key启动流程实例，key对应helloworld.bpmn文件中id的属性值，使用key值启动，默认是按照最新版本的流程定义启动
 22     System.out.println("流程实例ID:"+pi.getId());//流程实例ID    101
 23     System.out.println("流程定义ID:"+pi.getProcessDefinitionId());//流程定义ID   helloworld:1:4
 24 }
 25 
 26 /**查询当前人的个人任务*/
 27 @Test
 28 public void findMyPersonalTask(){
 29     String assignee = "张三";
 30     List list = processEngine.getTaskService()//与正在执行的任务管理相关的Service
 31                     .createTaskQuery()//创建任务查询对象
 32                     .taskAssignee(assignee)//指定个人任务查询，指定办理人
 33                     .list();
 34     if(list!=null && list.size()>0){
 35         for(Task task:list){
 36             System.out.println("任务ID:"+task.getId());
 37             System.out.println("任务名称:"+task.getName());
 38             System.out.println("任务的创建时间:"+task.getCreateTime());
 39             System.out.println("任务的办理人:"+task.getAssignee());
 40             System.out.println("流程实例ID："+task.getProcessInstanceId());
 41             System.out.println("执行对象ID:"+task.getExecutionId());
 42             System.out.println("流程定义ID:"+task.getProcessDefinitionId());
 43             System.out.println("########################################################");
 44         }
 45     }
 46 }
 47 
 48 /**完成我的任务*/
 49 @Test
 50 public void completeMyPersonalTask(){
 51     //任务ID
 52     String taskId = "204";
 53     processEngine.getTaskService()//与正在执行的任务管理相关的Service
 54                 .complete(taskId);
 55     System.out.println("完成任务：任务ID："+taskId);
 56 }

二：Activiti 数据库表结构

1:简单概述：

  1 /*
  2 Execution 执行对象
  3 按流程定义的规则执行一次的过程.
  4 对应的表：
  5 act_ru_execution： 正在执行的信息
  6 act_hi_procinst：已经执行完的历史流程实例信息
  7 act_hi_actinst：存放历史所有完成的活动
  8 ProcessInstance 流程实例
  9 特指流程从开始到结束的那个最大的执行分支，一个执行的流程中，流程实例只有 1 个。
 10 注意
 11 （1）如果是单例流程，执行对象 ID 就是流程实例 ID
 12 （2）如果一个流程有分支和聚合，那么执行对象 ID 和流程实例 ID 就不相同
 13 （3）一个流程中，流程实例只有 1 个，执行对象可以存在多个。
 14 Task 任务
 15 执行到某任务环节时生成的任务信息。
 16 对应的表：
 17 act_ru_task：正在执行的任务信息
 18 act_hi_taskinst：已经执行完的历史任务信息
 19 
 20 */

2:activiti5.13 框架数据库设计说明书

作者：liangjunjie

1、结构设计

1.1、逻辑结构设计

Activiti 使用到的表都是 ACT_ 开头的。

ACTRE:

’RE’表示 repository(存储)，RepositoryService 接口所操作的表。带此前缀的表包含的是静态信息，如，流程定义，流程的资源（图片，规则等）。

ACTRU:

‘RU’表示 runtime，运行时表 -RuntimeService。这是运行时的表存储着流程变量，用户任务，变量，职责（job）等运行时的数据。Activiti 只存储实例执行期间的运行时数据，当流程实例结束时，将删除这些记录。这就保证了这些运行时的表小且快。

ACTID:

’ID’表示 identity (组织机构)，IdentityService 接口所操作的表。用户记录，流程中使用到的用户和组。这些表包含标识的信息，如用户，用户组，等等。

ACTHI:

’HI’表示 history，历史数据表，HistoryService。就是这些表包含着流程执行的历史相关数据，如结束的流程实例，变量，任务，等等

ACTGE:

全局通用数据及设置 (general)，各种情况都使用的数据。

1.2、所有表的含义

序号表名说明 1 act_ge_bytearray 二进制数据表 2 act_ge_property 属性数据表存储整个流程引擎级别的数据, 初始化表结构时，会默认插入三条记录， 3 act_hi_actinst 历史节点表 4 act_hi_attachment 历史附件表 5 act_hi_comment 历史意见表 6 act_hi_identitylink 历史流程人员表 7 act_hi_detail 历史详情表，提供历史变量的查询 8 act_hi_procinst 历史流程实例表 9 act_hi_taskinst 历史任务实例表 10 act_hi_varinst 历史变量表 11 act_id_group 用户组信息表 12 act_id_info 用户扩展信息表 13 act_id_membership 用户与用户组对应信息表 14 act_id_user 用户信息表 15 act_re_deployment 部署信息表 16 act_re_model 流程设计模型部署表 17 act_re_procdef 流程定义数据表 18 act_ru_event_subscr throwEvent、catchEvent 时间监听信息表 19 act_ru_execution 运行时流程执行实例表 20 act_ru_identitylink 运行时流程人员表，主要存储任务节点与参与者的相关信息 21 act_ru_job 运行时定时任务数据表 22 act_ru_task 运行时任务节点表 23 act_ru_variable 运行时流程变量数据表

2、表以及索引信息

2.1 二进制数据表（act_gebytearray）

2.1.1 简要描述

保存流程定义图片和 xml、Serializable(序列化)的变量, 即保存所有二进制数据，特别注意类路径部署时候，不要把 svn 等隐藏文件或者其他与流程无关的文件也一起部署到该表中，会造成一些错误（可能导致流程定义无法删除）。

2.1.2 表结构说明

字段名称字段描述数据类型主键为空取值说明 ID ID nvarchar(64) √ 　主键 ID REV 乐观锁 int 　 √ Version(版本) NAME_ 名称 nvarchar(255) 　 √ 部署的文件名称，如：mail.bpmn、mail.png 、mail.bpmn20.xml DEPLOYMENT ID 部署 ID nvarchar(64) 　 √ 部署表 ID BYTES 字节 varbinary(max) 　 √ 部署文件 GENERATED 是否是引擎生成 tinyint 　 √ 0 为用户生成 1 为 Activiti 生成

2.1.3 索引说明

索引名称组成字段名称索引类型索引说明 PRIMARY ID_ Unique 主键唯一索引 ACT_FK_BYTEARR_DEPL DEPLOYMENT ID 　　

2.2 属性数据表( act_geproperty )

2.2.1 简要描述

属性数据表。存储整个流程引擎级别的数据。

2.2.2 表结构说明

字段名称字段描述数据类型主键为空取值说明 NAME 名称 nvarchar(64) √ 　 schema.version 　　　　 schema.history 　　　　 next.dbid VALUE_ 值 nvarchar(300) 　 √ 5 　　　　 create(5.*) REV 乐观锁 int 　 √ version

2.2.3 索引说明

索引名称组成字段名称索引类型索引说明 PRIMARY NAME Unique 主键唯一索引　　　　

2.3 历史节点表（act_hi_actinst）

2.3.1 简要描述

　　历史活动信息。这里记录流程流转过的所有节点，与 HITASKINST 不同的是，taskinst 只记录 usertask 内容

2.3.2 表结构说明

字段名称字段描述数据类型主键为空取值说明 ID ID_ nvarchar(64) √ 　　 PROC_DEF ID 流程定义 ID nvarchar(64) 　　　 PROC_INST ID 流程实例 ID nvarchar(64) 　　　 EXECUTION ID 执行实例 ID nvarchar(64) 　　　 ACT ID 节点 ID nvarchar(225) 　　节点定义 ID TASK ID 任务实例 ID nvarchar(64) 　 √ 任务实例 ID 其他节点类型实例 ID 在这里为空 CALL_PROC_INST ID 调用外部的流程实例 ID nvarchar(64) 　 √ 调用外部流程的流程实例 ID' ACT NAME 节点名称 nvarchar(225) 　 √ 节点定义名称 ACT TYPE 节点类型 nvarchar(225) 　　如 startEvent、userTask ASSIGNEE_ 签收人 nvarchar(64) 　 √ 节点签收人 START TIME 开始时间 datetime 　　 2013/9/15 11:30 END TIME 结束时间 datetime 　 √ 2013/9/15 11:30 DURATION 耗时 numeric(19,0) 　 √ 毫秒值

2.3.3 索引说明

索引名称组成字段名称索引类型索引说明 PRIMARY ID Unique 主键唯一索引 ACT_IDX_HI_ACT_INST_START START TIME 　　 ACT_IDX_HI_ACT_INST_END END TIME 　　 ACT_IDX_HI_ACT_INST_PROCINST PROC_INSTID 、 ACT ID 　　 ACT_IDX_HI_ACT_INST_EXEC EXECUTIONID 、 ACT ID 　　

2.4 历史附件表( act_hiattachment )

2.4.1 简要描述

　　历史附件表。

2.4.2 表结构说明

字段名称字段描述数据类型主键为空取值说明 ID ID nvarchar(64) √ 　主键 ID REV 乐观锁 integer 　 √ Version USER ID 用户 ID nvarchar(255) 　 √ 用户 ID NAME 名称 nvarchar(255) 　 √ 附件名称 DESCRIPTION 描述 nvarchar(4000) 　 √ 描述 TYPE_ 类型 nvarchar(255) 　 √ 附件类型 TASK ID 任务实例 ID nvarchar(64) 　 √ 节点实例 ID PROC_INST ID 流程实例 ID nvarchar(64) 　 √ 流程实例 ID URL URL nvarchar(4000) 　 √ 附件地址 CONTENT ID 字节表的 ID nvarchar(64) 　 √ ACT_GE BYTEARRAY 的 ID

2.4.3 索引说明

索引名称组成字段名称索引类型索引说明 PRIMARY ID Unique 主键唯一索引

2.5 历史意见表( act_hicomment )

2.5.1 简要描述

　　历史意见表。

2.5.2 表结构说明

字段名称字段描述数据类型主键为空取值说明 ID ID nvarchar(64) √ 　主键 ID TYPE 类型 nvarchar(255) 　 √ 类型：event（事件）　　　　 comment（意见） TIME_ 时间 datetime 　　填写时间 ' USER ID 用户 ID nvarchar(64) 　 √ 填写人 TASK ID 节点任务 ID nvarchar(64) 　 √ 节点实例 ID PROC_INST ID 流程实例 ID nvarchar(255) 　 √ 流程实例 ID ACTION 行为类型 nvarchar(64) 　 √ 见备注 1 MESSAGE 基本内容 nvarchar(4000) 　 √ 用于存放流程产生的信息，比如审批意见 FULL MSG 全部内容 varbinary(max) 　 √ 附件地址

2.5.3 索引说明

索引名称组成字段名称索引类型索引说明 PRIMARY ID_ Unique 主键唯一索引

2.6 历史详情表( act_hidetail )

2.6.1 简要描述

　　历史详情表：流程中产生的变量详细，包括控制流程流转的变量，业务表单中填写的流程需要用到的变量等。

2.6.2 表结构说明

字段名称字段描述数据类型主键为空取值说明 ID ID nvarchar(64) √ 　主键 TYPE 类型 nvarchar(255) 　　见备注 2 PROC_INST ID 流程实例 ID nvarchar(64) 　 √ 流程实例 ID EXECUTION ID 执行实例 ID nvarchar(64) 　 √ 执行实例 ID TASK ID 任务实例 ID nvarchar(64) 　 √ 任务实例 ID ACT_INST ID 节点实例 ID nvarchar(64) 　 √ ACT_HI ACTINST 表的 ID NAME 名称 nvarchar(255) 　　名称 VAR TYPE 参数类型 nvarchar(255) 　 √ 见备注 3 REV 乐观锁 int 　 √ Version TIME 时间戳 datetime 　　创建时间 BYTEARRAY ID 字节表 ID nvarchar 　 √ ACT_GE BYTEARRAY 表的 ID DOUBLE DOUBLE double precision 　 √ 存储变量类型为 Double LONG LONG numeric 　 √ 存储变量类型为 long TEXT TEXT nvarchar 　 √ 存储变量值类型为 String TEXT2 TEXT2 nvarchar 　 √ 此处存储的是 JPA 持久化对象时，才会有值。此值为对象 ID

2.6.3 索引说明

索引名称组成字段名称索引类型索引说明组成字段名称索引类型索引说明 PRIMARY ID Unique 主键唯一索引 ACT_IDX_HI_ACT_INST_START START TIME 　　 ACT_IDX_HI_ACT_INST_END END TIME 　　 ACT_IDX_HI_ACT_INST_PROCINST PROC_INSTID 、 ACT ID 　　 ACT_IDX_HI_ACT_INST_EXEC EXECUTIONID 、 ACT ID 　　

2.7 历史流程人员表( act_ruidentitylink )

2.7.1 简要描述

　　任务参与者数据表。主要存储历史节点参与者的信息。

2.7.2 表结构说明

字段名称字段描述数据类型主键为空取值说明 ID ID nvarchar(64) √ 　 ID GROUP ID 组 ID nvarchar(255) 　 √ 组 ID TYPE_ 类型 nvarchar(255) 　 √ 备注 4 USER ID 用户 ID nvarchar(255) 　 √ 用户 ID TASK ID 节点实例 ID nvarchar(64) 　 √ 节点实例 ID PROC_INST ID 流程实例 ID nvarchar(64) 　 √ 流程实例 ID

2.7.3 索引说明

索引名称组成字段名称索引类型索引说明 PRIMARY ID_ Unique 主键唯一索引 ACT_IDX_HI_IDENT_LNK_USER USER ID Unique 　 ACT_IDX_HI_IDENT_LNK_TASK TASK ID 　　 ACT_IDX_HI_IDENT_LNK_PROCINST PROC_INST ID 　　

2.8 历史流程实例表（act_hiprocinst）

2.8.1 简要描述

　　历史流程实例表。

2.8.2 表结构说明

字段名称字段描述数据类型主键为空取值说明 ID ID_ nvarchar(64) √ 　主键 ID PROC_INST ID 流程实例 ID nvarchar(64) 　　流程实例 ID BUSINESS KEY 业务主键 nvarchar(255) 　 √ 业务主键，业务表单的 ID PROC_DEF ID 流程定义 ID nvarchar(64) 　　流程定义 ID START TIME 开始时间 datetime 　　开始时间 END TIME 结束时间 datetime 　 √ 结束时间 DURATION_ 耗时 Numeric(19) 　 √ 耗时 START_USER ID 起草人 nvarchar(255) 　 √ 起草人 START_ACT ID 开始节点 ID nvarchar(255) 　 √ 起草环节 ID END_ACT ID 结束节点 ID nvarchar(255) 　 √ 结束环节 ID SUPER_PROCESS_INSTANCEID 父流程实例 ID nvarchar(64) 　 √ 父流程实例 ID DELETE REASON 删除原因 nvarchar(4000) 　 √ 删除原因

2.8.3 索引说明

索引名称组成字段名称索引类型索引说明 PRIMARY ID_ Unique 主键唯一索引 PROC_INST ID PROC_INST ID Unique 外键 ACT_UNIQ_HI_BUS_KEY PROC_DEFID,BUSINESS KEY Unique 　 ACT_IDX_HI_PRO_INST_END END TIME 　　 ACT_IDX_HI_PRO_I_BUSKEY BUSINESS KEY 　　

2.9 历史任务实例表( act_hitaskinst )