Activiti基础教程--01(简介、代码生成Activiti的25张表、Activiti配置文件activiti.cfg.xml生成25张表、在Eclipse上安装Activiti插件)

gihub:https://github.com/changwensir/Activiti/tree/master/ActivitiDemo1

一、简介

    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通过标准审定。 加入Alfresco Activiti项目的是VMware的SpringSource分支,Alfresco的计划把该项目提交给Apache基础架构,希望吸引更多方面的BPM专家和促进BPM的创新。

Activiti基础教程--01(简介、代码生成Activiti的25张表、Activiti配置文件activiti.cfg.xml生成25张表、在Eclipse上安装Activiti插件)

Activiti官方主页:http://www.activiti.org/index.html
Activiti下载:http://www.activiti.org/download.html
用户指南中文:http://activiti.org/userguide/index.html(我们通过用户指南来学习Activiti)
在线API文档: http://activiti.org/javadocs/index.html(我们开发的时候,要用到)

二、代码Activiti的25张表

    Activiti的运行支持,必须要有Activiti的25张表,主要是在流程运行过程中,记录存储一些参与流程的用户主体,
组,以及流程定义的存储,流程执行时候的一些信息,以及流程的历史信息等(后面我们会详细介绍这些表作用)

  我们先写一个小实例,来把Activiti的25张表自动生成出来;
  我们先建一个Maven项目 ActivitiDemo1
pom.xml里加上 Activiti支持,以及mysql驱动包。

[java] view plain copy
  1. <dependencies>  
  2.      <dependency>  
  3.         <groupId>org.activiti</groupId>  
  4.         <artifactId>activiti-engine</artifactId>  
  5.         <version>5.19.0.2</version>  
  6.     </dependency>  
  7.        
  8.     <dependency>  
  9.         <groupId>org.activiti</groupId>  
  10.         <artifactId>activiti-spring</artifactId>  
  11.         <version>5.19.0.2</version>  
  12.     </dependency>  
  13.        
  14.     <dependency>  
  15.         <groupId>org.activiti</groupId>  
  16.         <artifactId>activiti-bpmn-model</artifactId>  
  17.         <version>5.19.0.2</version>  
  18.     </dependency>  
  19.        
  20.     <dependency>  
  21.         <groupId>mysql</groupId>  
  22.         <artifactId>mysql-connector-java</artifactId>  
  23.         <version>5.1.38</version>  
  24.     </dependency>  
  25.        
  26. </dependencies>  

然后我们创建一个单元测试类 ActivitiTest01  (注意,有时候用自己的junit jar包,会出现诡异问题,所以我们推荐用eclipse插件自带的junit jar包)

创建后的项目结构如下:

Activiti基础教程--01(简介、代码生成Activiti的25张表、Activiti配置文件activiti.cfg.xml生成25张表、在Eclipse上安装Activiti插件)

  然后我们写一个测试方法,testCreateTable,并且在创建db_activiti数据库;
  我们要先来获取流程引擎配置,然后来配置流程引擎,要配置驱动包,url,数据库用户名,密码;还要设置schema,这里的schema要设置成update。这样可以自动更新,配置后,我们通过配置来获取流程引擎。创建实例的时候我们就可以自动生成需要的25张表。
[java] view plain copy
  1. package com.java1234.activiti.test;  
  2.    
  3. import org.activiti.engine.ProcessEngine;  
  4. import org.activiti.engine.ProcessEngineConfiguration;  
  5. import org.junit.Test;  
  6.    
  7. public class ActivitiTest01 {  
  8.    
  9.     /** 
  10.      * 生成25张Activiti表 
  11.      */  
  12.     @Test  
  13.     public void testCreateTable() {  
  14.         // 引擎配置  
  15.         ProcessEngineConfiguration pec=ProcessEngineConfiguration.createStandaloneProcessEngineConfiguration();  
  16.         pec.setJdbcDriver("com.mysql.jdbc.Driver");  
  17.         pec.setJdbcUrl("jdbc:mysql://localhost:3306/db_activiti?useUnicode=true&characterEncoding=utf8");  
  18.         pec.setJdbcUsername("root");  
  19.         pec.setJdbcPassword("123456");  
  20.            
  21.         /** 
  22.          * DB_SCHEMA_UPDATE_FALSE 不能自动创建表,需要表存在 
  23.          * create-drop 先删除表再创建表 
  24.          * DB_SCHEMA_UPDATE_TRUE 如何表不存在,自动创建和更新表   
  25.          */  
  26.         pec.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);  
  27.            
  28.         // 获取流程引擎对象  
  29.         ProcessEngine processEngine=pec.buildProcessEngine();  
  30.     }  
  31.    
  32. }  
我们运行测试类,运行完我们刷新数据库,即可看到25张表:
Activiti基础教程--01(简介、代码生成Activiti的25张表、Activiti配置文件activiti.cfg.xml生成25张表、在Eclipse上安装Activiti插件)

    ACT_RE_*: 'RE'表示repository。 这个前缀的表包含了流程定义和流程静态资源 (图片,规则,等等)。
    ACT_RU_*: 'RU'表示runtime。 这些运行时的表,包含流程实例,任务,变量,异步任务,等运行中的数据。 Activiti只在流程实例执行过程中保存这些数据, 在流程结束时就会删除这些记录。 这样运行时表可以一直很小速度很快。
    ACT_ID_*: 'ID'表示identity。 这些表包含身份信息,比如用户,组等等。
    ACT_HI_*: 'HI'表示history。 这些表包含历史数据,比如历史流程实例, 变量,任务等等。
    ACT_GE_*: 'GE'表示general。通用数据, 用于不同场景下,如存放资源文件。
这些表结构,还有一些辅助表。我们后续会详细解释,这里大家先大体了解即可;

表结构操作:
1、资源库流程规则表
  1).act_re_deployment     部署信息表
  2).act_re_model      流程设计模型部署表
  3).act_re_procdef      流程定义数据表
2、运行时数据库表
  1).act_ru_execution            运行时流程执行实例表
  2).act_ru_identitylink    运行时流程人员表,主要存储任务节点与参与者的相关信息
  3).act_ru_task        运行时任务节点表
  4).act_ru_variable        运行时流程变量数据表
3、历史数据库表
  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        历史变量表
4、组织机构表
  1).act_id_group        用户组信息表
  2).act_id_info        用户扩展信息表
  3).act_id_membership            用户与用户组对应信息表
  4).act_id_user        用户信息表
这四张表很常见,基本的组织机构管理,关于用户认证方面建议还是自己开发一套,组件自带的功能太简单,使用中有很多需求难以满足 
5、通用数据表
  1).act_ge_bytearray        二进制数据表
  2).act_ge_property        属性数据表存储整个流程引擎级别的数据,初始化表结构时,会默认插入三条记录,

三、Activiti配置文件activiti.cfg.xml生成25张表

  前面我们用代码实现了生成25张activiti表,今天我们用Activiti提供的activiti.cfg.xml配置文件来简化实现前面的功能
  官方文档参考地址:http://activiti.org/userguide/index.html#configuration 

我们先在src/test/resources下创建一个xml文件 名字是:activiti.cfg.xml,然后我们从官方文档贴下参考的xml代码:

[html] view plain copy
  1. <beans xmlns="http://www.springframework.org/schema/beans"  
  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.    
  5.   <bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">  
  6.    
  7.     <property name="jdbcUrl" value="jdbc:h2:mem:activiti;DB_CLOSE_DELAY=1000" />  
  8.     <property name="jdbcDriver" value="org.h2.Driver" />  
  9.     <property name="jdbcUsername" value="sa" />  
  10.     <property name="jdbcPassword" value="" />  
  11.    
  12.     <property name="databaseSchemaUpdate" value="true" />  
  13.    
  14.     <property name="jobExecutorActivate" value="false" />  
  15.     <property name="asyncExecutorEnabled" value="true" />  
  16.     <property name="asyncExecutorActivate" value="false" />  
  17.    
  18.     <property name="mailServerHost" value="mail.my-corp.com" />  
  19.     <property name="mailServerPort" value="5025" />  
  20.   </bean>  
  21.    
  22. </beans>  
  这里的话,我们要根据我们的项目 修改jdbcUrl jdbcDriver jdbcUsername jdbcPassword 当然还有下面的配置我们可以去掉一些 后面会降到这些配置的用途;修改完后的xml如下:
[html] view plain copy
  1. <?xml version="1.0" encoding="UTF-8"?>  
  2. <beans xmlns="http://www.springframework.org/schema/beans"  
  3.        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
  4.        xsi:schemaLocation="http://www.springframework.org/schema/beans   http://www.springframework.org/schema/beans/spring-beans.xsd">  
  5.    
  6.   <bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">  
  7.    
  8.     <property name="jdbcUrl" value="jdbc:mysql://localhost:3306/db_activiti?useUnicode=true&amp;characterEncoding=utf8" />  
  9.     <property name="jdbcDriver" value="com.mysql.jdbc.Driver" />  
  10.     <property name="jdbcUsername" value="root" />  
  11.     <property name="jdbcPassword" value="123456" />  
  12.  <!-- 对应 DB_SCHEMA_UPDATE_TRUE 如何表不存在,自动创建和更新表 -->  
  13.     <property name="databaseSchemaUpdate" value="true" />  
  14.    
  15.   </bean>  
  16.    
  17. </beans>  
接下来我们就是要通过代码来读取配置文件,然后获取工作流引擎实例(测试的时候 先把前面db_activiti数据下的表 全部删除;):
[java] view plain copy
  1. /** 
  2.  * 使用xml配置 简化 
  3.  */  
  4. @Test  
  5. public void testCreateTableWithXml(){  
  6.     // 引擎配置  
  7.     ProcessEngineConfiguration pec=ProcessEngineConfiguration.createProcessEngineConfigurationFromResource("activiti.cfg.xml");  
  8.     // 获取流程引擎对象  
  9.     ProcessEngine processEngine=pec.buildProcessEngine();  
  10. }  
然后运行上面的测试类,我们会发现 表自动生成了:
Activiti基础教程--01(简介、代码生成Activiti的25张表、Activiti配置文件activiti.cfg.xml生成25张表、在Eclipse上安装Activiti插件)

表依然是前面的25张表;我们会发现,使用xml配置会简化很多东西。

四、在Eclipse上安装Activiti插件

这里我们在自己的eclipse来装下这个牛逼轰轰的插件:

首先打开Eclipse(J2ee版本的,最好用新的版本,Maven啥的都支持,不要搞个老古董)

然后点击help -> Install new Software 

Activiti基础教程--01(简介、代码生成Activiti的25张表、Activiti配置文件activiti.cfg.xml生成25张表、在Eclipse上安装Activiti插件)

然后点击 Add

Activiti基础教程--01(简介、代码生成Activiti的25张表、Activiti配置文件activiti.cfg.xml生成25张表、在Eclipse上安装Activiti插件)

我们在Name上 写上 Activiti BPMN 2.0 designer

Location上写上 http://activiti.org/designer/update/  (插件更新地址)

然后点击 OK 按钮

Activiti基础教程--01(简介、代码生成Activiti的25张表、Activiti配置文件activiti.cfg.xml生成25张表、在Eclipse上安装Activiti插件)

勾选下,然后next:

Activiti基础教程--01(简介、代码生成Activiti的25张表、Activiti配置文件activiti.cfg.xml生成25张表、在Eclipse上安装Activiti插件)

继续next

Activiti基础教程--01(简介、代码生成Activiti的25张表、Activiti配置文件activiti.cfg.xml生成25张表、在Eclipse上安装Activiti插件)

点下接受,然后 Finish 
Activiti基础教程--01(简介、代码生成Activiti的25张表、Activiti配置文件activiti.cfg.xml生成25张表、在Eclipse上安装Activiti插件)

中间可能会一些安全提示,点 OK 即可;

Activiti基础教程--01(简介、代码生成Activiti的25张表、Activiti配置文件activiti.cfg.xml生成25张表、在Eclipse上安装Activiti插件)

这里我们点Yes,重启下Eclipse;才会生效;

为了验证我们是否成功安装插件,我们点击File -> New -> Others

Activiti基础教程--01(简介、代码生成Activiti的25张表、Activiti配置文件activiti.cfg.xml生成25张表、在Eclipse上安装Activiti插件)

我们如果看到这个,说明就已经安装成功了。后面我们会具体讲这东西怎么用;

这里我们有个地方要设置下,点下Window - > Preferences

Activiti基础教程--01(简介、代码生成Activiti的25张表、Activiti配置文件activiti.cfg.xml生成25张表、在Eclipse上安装Activiti插件)

这里我先大体解释下。后面学习的时候 会创建图表,以及生成一张图片。我们这里打上勾。

保存图表的时候,就创建图片。我们开发的时候必须这么配置;(后面大家会明白的,先这样设置)


OK到这里的话,插件已经安装和设置完毕了。

转载:http://blog.csdn.net/ochangwen/article/details/51907392