使用Activit的朋友都知道Activiti对应的有28张表,今天我们就来说下Activit中28张表对应的含义是什么?
如何创建表?
在Activiti中创建表有三种方式,我们依次来看下:
一、通过硬编码的形式直接指定
// 创建一个流程成引擎对像 ProcessEngineConfiguration processEngineConfiguration = ProcessEngineConfiguration .createStandaloneInMemProcessEngineConfiguration(); // 设置数据库连接信息 processEngineConfiguration.setJdbcDriver("com.mysql.jdbc.Driver"); processEngineConfiguration.setJdbcUrl("jdbc:mysql://localhost:3306/db_activiti"); processEngineConfiguration.setJdbcUsername("root"); processEngineConfiguration.setJdbcPassword(""); processEngineConfiguration.setDatabaseType("mysql"); processEngineConfiguration.setDatabaseSchemaUpdate("update"); // 设置自动创建表 processEngineConfiguration.setDatabaseSchemaUpdate("true"); // 在创建引擎对象的时候自动创建表 ProcessEngine processEngine = processEngineConfiguration.buildProcessEngine();
二、通过activit.cfg.xml配置文件
<?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.StandaloneProcessEngineConfiguration"> <property name="jdbcUrl" value="jdbc:mysql://localhost:3306/db_activiti?characterEncoding=utf8" /> <property name="jdbcDriver" value="com.mysql.jdbc.Driver" /> <property name="jdbcUsername" value="root" /> <property name="jdbcPassword" value="" /> <property name="databaseSchemaUpdate" value="true" /> <property name="databaseType" value="mysql"></property> </bean> </beans>
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
三、使用配置文件,在资源目录下创建activiti-context.xml
<!-- 创建流程引擎配置对象 --> <bean id="ProcessEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneInMemProcessEngineConfiguration"> <property name="jdbcDriver" value="com.mysql.jdbc.Driver"/> <property name="jdbcUrl" value="jdbc:mysql://localhost:3306/db_activiti" /> <property name="jdbcUsername" value="root" /> <property name="jdbcPassword" value="" /> <property name="databaseSchemaUpdate" value="true" /> </bean>
代码里边读取加载配置文件
String resource = "activiti-context.xml"; String beanName = "ProcessEngineConfiguration"; ProcessEngineConfiguration cf = ProcessEngineConfiguration.createProcessEngineConfigurationFromResource(resource, beanName); ProcessEngine processEngine = cf.buildProcessEngine();
以上就是创建表的三种方式,接下来我们看创建好的表都有哪些?
先上一张图,后面详细说。
Activiti中表的详细介绍
通用数据表
通用数据表用于存放一些通用的数据,这些表本身不关心特定的流程或者业务,只用于其存放这些业务或者流程所使用的特定的资源,它们可以独立存在于流程引擎或者应用系统当中,其他的数据表也可以使用这些表的数据,它们都是以ACT_GE开头,GE的单词是general前两个字母的缩写。
ACT_GE_BYTEARRAY
用于保存与流程引擎相关的资源,只要调用了Activit存储服务的API,其提供的资源均会转换成byte数组并保存到这个表中。资源表设计了一个byte字段,用来保存资源的内容,因此理论上可以保存任何资源类型(文件,或者其他来源的输入流)。一般情况下,Activit使用这个表来保存字符串、流程文件的内容和流程图片内容等。
ACT_GE_BYTEARRAY
- ID_:数据表的主键,在Mysql中字段类型为varchar,长度位64,Activit有自己的主键生成策略,每个数据表的ID_字段值,在整个流程中是唯一的
- REV_:数据版本,Activit为一些有可能频繁修改的数据表加入该字段,用来标识该数据被操作的次数。
- NAME_:资源名称,类型为varchar,长度255
- DEPLOYMENT_ID_:一次部署可以添加多个资源,该字段与部署表ACT_RE_DEPLOYMENT的主键关联
- BYTES_:资源内容,数据类型为longblob,最大可存储4GB的数据
- GENERATED_:是由Activit自动产生的数据,0表示false,1表示true
属性表
ACT_GE_PROPERTY
Activit将全部的属性抽象为 key-value对,每个属性都有名称和值,使用ACT_GE_PROPERTY来保存这些属性,该表的字段包含如下:
- NAME_:属性名称,varchar类型,长度64
- VALUE_:属性值,长度300
- REV_:数据的版本号
流程存储表
流程引擎中使用存储表来保存流程定义和部署信息这类数据,存储表名称以ACT_RE开头,RE是repository单词的前两个字母,可以理解为仓库的意思
部署数据表
在Activit中,一次部署可以添加多个资源,资源会被保存到资源表(ACT_GE_BYTEARRA)中,而部署信息,则保存到部署表中,部署表位ACT_RE_DEPLOYMENT,其包含以下三个字段
ACT_RE_DEPLOYMENT
- ID_:主键
- NAME_:部署名称
- DEPLOYMENT_TIME_:部署时间,类型为timestamp
以上是哪个字段除了NAME_可以不设置之外,其他字段在数据写入时必须设置值
流程定义表
Activit在部署添加资源时,如果发布部署文件是流程文件(.bpmn或者.bpmn20.xml)其除了会讲内容保存到资源表外,还会解析流程文件的内容,并形成特定的流程定义数据,写入到流程定义表中(ACT_RE_PROCDEF),ACT_RE_PROCDEF包含以下字段:
ACT_RE_PROCDEF
- ID_:主键,与其他数据表不同的是,ACT_RE_PROCDEF表的主键是组合主键,一般使用一定的规则来产生主键
- REV_:数据版本号
- CATEGORY_:流程定义分类
- NAME_:流程定义名称
- KEY_: 流程定义的KEY
- VERSION_:流程定义的版本
- DEPLOYMENT_ID_:流程定义的对应的资源名称,一般为流程文件的相对路径
- RESOURCE_NAME_:流程定义的对应的资源名称
- DGRM_RERSOURCE_NAME_:流程定义的对应流程图的资源名称
- HAS_START_FORM_KEY_:流程文件是否有开始表单,可以在时间中使用activiti:formKey属性来配置开始表单
- SUSPENSION_STATE_:表示流程定义的状态是激活还是终止,如果是终止,那么将不能启动流程
身份数据表
Activit的整个身份模块,可以独立于流程引擎而存在,身份数据表并没有保存流程相关的数据以及关联,身份表的名称使用ACT_ID开头,ID的单词是identity的前两个字母。
用户表
流程引擎用户的信息被保护在ACT_ID_UESR表中,该表有以下几个字段
ACT_ID_UESR
- ID_:主键
- REV_:数据版本号
- FIRST_:名字的名称
- LAST_:名字的姓氏
- EMAIL_:用户邮箱
- PWD_:用户密码
- PICTURE_ID_:用户图片,对应资源表的数据ID
用户账号(信息)表
Activit将用户,用户账号和身份信息分成三种数据,其中用户表保存用户的数据,而用户账号和用户信息则被保存到ACT_ID_INFO表中,该类有如下字段
ACT_ID_INFO
- ID_:主键
- REV_:数据版本
- USER_ID_:对应用户表的数据ID
- TYPE_:信息类型,当前可以设置用户的帐号(account)、用户信息(userinfo)和NULL三种值
- KEY_:数据的键
- VALUE_:数据的值
- PASSWORD_:用户帐号的密码字段,不过当前Activiti并没有使用该字段
- PARENT_ID_:该信息的父信息ID,如果一条数据设置父信息ID,则表示该数据是用户帐号(信息)的明细数据。比如有个信息有明细,那么明细就是这个帐号的数据。
用户组表
ACT_ID_GROUP
- ID_:主键
- REV_:数据版本
- NAME_:用户组名称
- TYPE_:用户组类型,类型不由Activit提供,某些业务中,Activit会根据该字段进行查询。
关系表
ACT_ID_MEMBERSHIP
- USER_ID_:用户ID,不能为null
- GROUP_ID_:用户组ID,不能为null
运行时数据表
运行时数据表用来保存流程在运行过程中所产生的数据,例如流程实例、执行流和任务等。运行时数据表的名称以ACT_ RU开头,RU是单词runtime的前两个字母。
流程实例(执行流)表
当流程启动后,会产生-一个流程实例,同时会产生相应的执行流,流程实例和执行流数据均被保存在ACT_ RU_ EXECUTION表中。如果一个流程实例只有一条执行流,那么该表中只产生一条数据,该数据既表示执行流,也表示流程实例。ACT_ RU_ EXECUTION表有以下字段。
ACT_ RU_ EXECUTION
- ID_:主键,由Activiti的主键生成策略产生。
- REV_: 数据版本。
- PROC_ INST_ _ID_ :流程实例ID,一个流程实例有可能会产生多个执行流,该字段表示执行流所属的流程实例。
- BUSINESS_ KEY_ :启动流程时指定的业务主键。
- PARENT_ ID_ :流程实例(执行流)的ID, 一个流程实例有可能会产生执行流,新的执行流数据以该字段标识其所属的流程实例。
- PROC_ DEF_ _ID_ :流程定义数据的ID。
- SUPER_ EXEC_ :父执行流的ID,一个执行流可以产生新的流程实例,该流程实例数据使用该字段标识其所属的流程实例。
- ACT_ ID_ :当前执行流行为的ID, ID在流程文件中定义。
- IS_ ACTIVE_ :该执行流是否活跃的标识。
- IS_ CONCURRENT_ :执行流是否正在并行。
- IS_ SCOPE :是否在执行流范围内。
- IS_ EVENT_ SCOPE_ :是否在事件范围内。
- SUSPENSION STATE_ :标识流程的中断状态。
- CACHED_ ENT_ STATE_ :流程实体的缓存,取值为0~7。
流程任务表
流程在运行过程中所产生的任务数据保存在ACT_ RU_TASK表中,任务有如下字段。
ACT_ RU_TASK
- ID_: 主键,由Activiti的主键生成策略产生。
- REV_:数据版本号。
- EXECUTION _ID_ :任务所处的执行流ID。
- PROC_ _INST_ .ID_ :对应的流程实例ID。
- PROC_ DEF _ID_ :对应流程定义数据的ID。
- NAME_ :任务名称,在流程文件中定义。
- PARENT_TASK_ ID_ :父任务ID, 子任务才会设置该字段的值。
- DESCRIPTION_ :任务描述,在流程文件中配置。
- TASK_ DEF_ KEY_ :任务定义的ID值,在流程文件中定义。
- OWNER_ :任务拥有人,没有做外键关联。
- ASSIGNEE_ :被指派执行该任务的人,没有做外键关联。
- DELEGATION_ :任务委托状态,有等候中和已解决两种状态。
- PRIORITY_: 任务优先级,默认为50, 类型为int, 长度为11
- CREATE .TIME_ :任务创建时间,类型为timestamp。
- DUE_ DATE_ :任务预订日期,类型为datetime
流程参数表
Activiti提供了ACT_ RU_ VARIABLE表来存放流程中的参数,这类参数包括流程实例参数、执行流参数和任务参数。参数可以会有多种类型,因此该表有多个字段用来存放参数值。ACT_ RU_ VARIABLE表有以下字段。
ACT_ RU_ VARIABLE
- ID_:主键,由Activiti 的主键生成策略产生。
- REV_: 数据版本号。
- TYPE_ :参数类型,该字段值可以为boolean. bytes、serializable. date. double、 integer、jpa-entity、long、 null、 short 或string,这些字段值均为Activiti 提供,还可以通过自定义来扩展参数类型。
- NAME_ :参数名称。
- EXECUTION_ ID_: 该参数对应的执行ID, 可以为null.
- PROC_ INST_ ID_ :该参数对应的流程实例ID, 可以为null。
- TASK_ ID_ :如果该参数是任务参数,就需要设置任务ID。
- BYTEARRAY .ID_ :如果参数值是序列化对象,那么可以将该对象作为资源保存到资源表中,该字段保存资源表中数据的ID.
- DOUBLE_:参数类型为double,则值会保存到该字段中。
- LONG_ :参数类型为long, 则值会保存到该字段中。
- TEXT_:用于保存文本类型的参数值,该字段为varchar 类型,长度为4 000。
- TEXT2_ :与TEXT_字段一样,用于保存文本类型的参数值。
流程与身份关系表
用户组和用户之间存在的关系,使用ACT_ ID_ MEMBERSHIP表保存。用户或者用户组与流程数据之间的关系,则使用ACT_ RU_ IDENTITYLINK表进行保存。相比于ACT_ ID _MEMBERSHIP表,ACT_ RU_ IDENTITYLINK 表的字段更多一些。
ACT_ RU_ IDENTITYLINK
- ID_:主键,由Activiti的主键生成策略产生。
- REV_ :数据版本号。
- GROUP_ _ID_ :该关系数据中的用户组ID。
- TYPE_ :该关系数据的类型,当前提供了3个值: assignee、 candidate和owner, 表示流程数据的指派人(组)、候选人(组)和拥有人。
- USER_ ID_ :关系数据中的用户ID。
- TASK_ID_ :关系数据中的任务ID.
- PROC DEF_ .ID_ :关系数据中的流程定义ID
工作数据表
在流程执行的过程中,会有一些工作需要定时或者重复执行,这类工作数据被保存到ACT RU_ JOB表中。ACT_ RU_ JOB表有以下字段。
ACT_ RU_ JOB
- ID_:主键,由Activiti的主键生成策略产生。
- REV_ :数据版本号。
- TYPE_:工作类型,值为message或者timer
- LOCK_EXP_TIME_:工作锁定的结束时间表示
- LOCK_OWNER_:工作锁定标识,默认为UUID
- EXCLUSIVE_:工作是否需要单独执行
- EXECUTION_ID_:产生工作的执行流ID
- PROCESS_INSTANCE_ID_:产生郭总的流程实例ID
- RETRIES_:工作的剩余执行次数,默认值为3
- EXCEPTION_STACK_ID_:当任务执行抛出异常时,异常堆栈信息会被保存到资源标中,该ID为关系资源表中存储的异常堆栈信息的数据ID
- EXCEPTION_MSG_:异常信息
- DUEDATE_:工作执行时间
- PEPEAT_:工作重复执行次数
- HANDLER_TYPE_:标识工作的处理类
- HANDLER_CFG_:工作相关的数据配置
事件描述表
ACT_RU_EVENT_SUBSCR
- ID_:
- REV_:
- EVENT_TYPE_:事件类型
- EVENT_NAME_:事件名称
- EXECUTION_ID_:事件所在的执流程ID
- PROC_INST_ID_:事件所在的流程实例ID
- ACTIVITY_ID_:具体事件的ID
- CONFIGURATION_:事件的属性配置
- CREATED_:事件的创建时间
历史数据表
历史数据表就像流程引擎的日志表。被操作过的流程元素,将会被记录到历史表中。历史数据表名称以ACT_ HI 开头,HI是单词history的前两个字母。
流程实例表
流程实例的历史数据会被保存到ACT_ HI_ PROCINST表中,只要流程被启动,Activiti 就会将流程实例的数据写入ACT_ HI_ PROCINST 表中。除了基本的流程字段外,与运行时数据表不同的是,历史流程实例表还会记录流程的开始活动ID、结束活动ID等信息。
ACT_HI_PROCINST
- START_ACT_ID:开始活动的ID
- END_ACT_ID:流程最后一个活动的ID
- EDLETE_REASON_:该流程实例删除的原因
流程明细表
流程明细表(ACT_ HI_ DETAIL)会记录流程执行过程中的参数或者表单数据。由于在流程执行过程中,会产生大量这类数据,因此默认情况下,Activiti 不会保存流程明细数据,除非将流程引擎的历史数据(history) 配置为full。流程的历史明细数据表与运行时参数表的设计类似.
当流程到达某个任务节点时,就会向历史任务表(ACT_ HI _TASKINST)中写入历史任务数据。历史任务表与运行时的任务表设计类似,在运行时任务表的基础上,额外提供了任务开始时间(START _TIME_ )、结束时间(END_ TIME_ )和删除原因(DELETE_ REASON_ )三个字段。其中开始时间和结束时间字段类型均为datetime,如果任务被正常完成,那么删除原因字段值为completed。
历史行为表(ACT_ HI_ ACTINST)会记录每一个流程活动的实例,- 一个流程活动将会被记录为一条数据。例如有一个流程,开始事件、用户任务和结束事件各有一个,当流程结束后,就会产生3条历史行为数据。历史行为表有如下字段。
ACT_HI_ACTINS
- ID_:主键,由Activiti主键生成策略产生。
- PROC_DEF_ ID_ :流程定义ID。
- PROC INST_ID_ :流程实例ID.
- EXECUTION_ID_ :执行流ID。
- ACT_ID_ :流程活动的ID, 在流程文件中定义。
- ACT_ NAME_ :活动的名称。
- ACT_TYPE_ :活动类型,例如开始事件,活动名称为startEvent。
- ASSIGNEE_ :活动指派人。
- START_TIME_ :活动开始时间,即执行流到达活动时的时间。
- END_TIME_ :活动结束时间,即执行流离开该活动时的时间。
- DURATION_:活动持续时间
-
附件表和评论表
ACT_ HI ATTACHMENT
- ID_:主键,由Activiti的主键生成策略产生。
- REV_: 数据版本号。
- USER_ .ID_ :附件对应的用户ID, 可以为null.➢NAME_ :附件名称。
- DESCRIPTION :附件描述。➢TYPE _: 附件类型。
- TASK_ ID_ :该附件对应的任务ID。
- PROC INST_ ID _:对应的流程实例ID。➢URL_ :连接到该附件的URL。
- CONTENT_ .ID_ :附件内容ID,附件的内容将会被保存到资源表中,该字段记录资源数据ID.
ACT_ HI_ COMMENT表实际不只保存评论数据,它还会保存某些事件数据,但它的表名.为COMMENT,因此更倾向把它叫作评论表,该表有如下字段。
ACT_ HI_ COMMENT
- ID_: 主键,由Activiti的主键生成策略产生。
- TYPE :评论的类型,可以设置为event或者comment, 表示事件记录数据或者评论数据。
- TIME_ :数据产生的时间。
- USER_ ID_: 产生评论数据的用户ID。
- TASK .ID_ :该评论数据的任务ID。
- PROC_ _INST .ID_ :数据对应的流程实例ID。
- ACTION :该评论数据的操作标识。
- MESSAGE_ :该评论数据的信息。
- FULL_ MSG_ :该字段同样记录评论数据的信息。