Activiti工作流
一、什么是工作流
工作流(Workflow)，就是“业务过程的部分或整体在计算机应用环境下的自动化”，它主要解决的是“使在多个参与者之间按照某种预定义的规则传递文档、信息或任务的过程自动进行，从而实现某个预期的业务目标，或者促使此目标的实现”。
工作流管理系统(Workflow Management System,WfMS)是一个软件系统，它完成工作量的定义和管理，并按照在系统中预先定义好的工作流逻辑进行工作流实例的执行。工作流管理系统不是企业的业务系统，而是为企业的业务系统的运行提供了一个软件的支撑环境。
二、 常见的工作流框架
流行的工作流框架有：Activity5.13、JBPM4.4、OSWorkFlow、WorkFlow
工作流框架底层需要有数据库提供支持，activiti5.13版本，有23张表。
JBPM4.4框架底层有数据库支持，18张表。
JBPM底层使用hibernate操作数据库。
Activiti框架底层使用的mybatis操作数据库。
三、 Activiti5介绍
Activiti5是由Alfresco软件在2010年5月17日发布的业务流程管理（BPM）框架，它是覆盖了业务流程管理、工作流、服务协作等领域的一个开源的、灵活的、易扩展的可执行流程语言框架。Activiti基于Apache许可的开源BPM平台，创始人Tom Baeyens是JBoss jBPM的项目架构师，它特色是提供了eclipse插件，开发人员可以通过插件直接绘画出业务流程图。
四、 安装activiti流程设计器插件
第一步：获得下载activiti-eclipse插件的安装包
第二步：解压安装包，复制解压文件里面的activiti到eclipse中的dropins目录中
第三步：重启eclipse，勾选save选项
第四步：如果重启eclipse无法显示activiti图标，表明所使用的eclipse版本不支持该插件，可以选择换myeclipse或其他版本的eclipse
五、 初始化activiti框架数据表
5.1 下载activiti框架
Activiti框架下载地址：http://activiti.org/
5.2创建一个数据库
5.3使用activiti框架的自动建表功能
activiti框架提供了和hibernate类似的自动建表功能
搭建开发环境：
第一步：创建一个Java项目activiti1110
第二步：导入jar包（从下载下来的activiti-5.13工作流引擎下面的DEMO导入jar包），还需要导入MySQL驱动包
1、不使用配置文件（不建议）
测试代码：
1 package net.csdn.activiti; 2 3 import org.activiti.engine.ProcessEngine; 4 importorg.activiti.engine.ProcessEngineConfiguration; 5 import org.junit.Test; 6 7 public class HelloWorld { 8 /** 9 * 使用activiti框架提供的自动建表(没有配置文件) 10 */ 11 12 @Test 13 public void test1(){ 14 //创建一个流程引擎配置对象 15 ProcessEngineConfiguration configuration =ProcessEngineConfiguration.createStandaloneProcessEngineConfiguration(); 16 //配置数据源 17 configuration.setJdbcDriver("com.mysql.jdbc.Driver"); 18 configuration.setJdbcUrl("jdbc:mysql://localhost:3306/activiti_1110?useUnicode=true&characterEncoding=UTF-8"); 19 configuration.setJdbcUsername("root"); 20 configuration.setJdbcPassword("root"); 21 //设置自动建表 22 configuration.setDatabaseSchemaUpdate("true"); 23 //创建一个流程引擎对象，在创建流程引擎对象过程中会自动创建表 24 ProcessEngine processEngine =configuration.buildProcessEngine(); 25 } 26 }
2、使用配置文件
配置文件activiti-context.xml如下：
1 <beans xmlns="http://www.springframework.org/schema/beans" 2 xmlns:context="http://www.springframework.org/schema/context" 3 xmlns:tx="http://www.springframework.org/schema/tx" 4 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 5 xsi:schemaLocation="http://www.springframework.org/schema/beans 6 http://www.springframework.org/schema/beans/spring-beans.xsd 7 http://www.springframework.org/schema/context 8 http://www.springframework.org/schema/context/spring-context-2.5.xsd 9 http://www.springframework.org/schema/tx 10 http://www.springframework.org/schema/tx/spring-tx-3.0.xsd"> 11 12 <!-- 配置流程引擎配置对象 --> 13 <bean id="processEngineConfiguration" 14 class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration"> 15 <property name="jdbcDriver" value="com.mysql.jdbc.Driver" /> 16 <property name="jdbcUrl" value="jdbc:mysql://localhost:3306/activiti_1110"/> 17 <property name="jdbcUsername" value="root" /> 18 <property name="jdbcPassword" value="root" /> 19 <property name="databaseSchemaUpdate" value="true" /> 20 </bean> 21 </beans>
测试代码：
1 /** 2 * 使用框架提供的自动建表（提供配置文件）---配置文件activiti-context.xml可以从框架提供的例子程序中获取 3 */ 4 @Test 5 public void test2() { 6 String resource = "activiti-context.xml";// 配置文件名称 7 String beanName = "processEngineConfiguration";// 配置id值 8 ProcessEngineConfiguration conf =ProcessEngineConfiguration 9 .createProcessEngineConfigurationFromResource(resource, 10 beanName); 11 ProcessEngine processEngine =conf.buildProcessEngine(); 12 }
3、使用配置文件（使用默认配置）
要求配置文件名称必须为activiti-context.xml或者activiti.cfg.xml因为,因为默认的配置ProcessEngines.getDefaultProcessEngine();会初始化这两个文件的其中一个，默认的配置信息如下：
测试代码：
1 /** 2 * 使用框架提供的自动建表（使用配置文件） 3 */ 4 @Test 5 public void test3() { 6 ProcessEngine processEngine =ProcessEngines.getDefaultProcessEngine(); 7 }
六、了解23张表
Activiti的后台是有数据库的支持，所有的表都以ACT_开头。 第二部分是表示表的用途的两个字母标识。用途也和服务的API对应。
1) ACT_RE_*: 'RE'表示repository。 这个前缀的表包含了流程定义和流程静态资源（图片，规则，等等）。
2) ACT_RU_*: 'RU'表示runtime。 这些运行时的表，包含流程实例，任务，变量，异步任务，等运行中的数据。 Activiti只在流程实例执行过程中保存这些数据，在流程结束时就会删除这些记录。 这样运行时表可以一直很小速度很快。
3) ACT_ID_*: 'ID'表示identity。 这些表包含身份信息，比如用户，组等等。
4) ACT_HI_*: 'HI'表示history。 这些表包含历史数据，比如历史流程实例，变量，任务等等。
5) 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 用户信息表
这四张表很常见，基本的组织机构管理，关于用户认证方面建议还是自己开发一套，组件自带的功能太简单，使用中有很多需求难以满足
通用数据表
1) act_ge_bytearray 二进制数据表
2) act_ge_property 属性数据表存储整个流程引擎级别的数据,初始化表结构时，会默认插入三条记录
七、核心对象ProcessEngine
ProcessEngine类，一般称为流程引擎类，没错，这个流程引擎就是我们上一篇文章中提到的流程引擎，它是activiti中最核心的类，并且这个类是线程安全的，所有的线程和请求都可以使用同一个ProcessEngine对象，其它常用类几乎也都是由它而来的。
方式1：使用classpath根目录下的默认配置文件jbpm.cfg.xml创建一个单例的ProcessEngine
ProcessEngineprocessEngine = ProcessEngines.getDefaultProcessEngine();
方式2：指定其他位置:配置文件，如src根目录config包下的my-jbpm-cfg.xml。
ProcessEngineprocessEngine = ProcessEngineConfiguration .createProcessEngineConfigurationFromResource("config/my-jbpm-cfg.xml").buildProcessEngine();
八、service
1、RepositoryService：
RepositoryService是管理流程定义的仓库服务的接口。
RepositoryServicerepositoryService = processEngine.getRepositoryService();
2、RuntimeService：
RuntimeService是activiti的流程执行服务类。可以从这个服务类中获取很多关于流程执行相关的信息，如执行管理，包括启动、推进、删除流程实例等操作。
RuntimeServiceruntimeService = processEngine.getRuntimeService();
3、TaskService:
TaskService是activiti的任务服务类。可以从这个类中获取任务的信息。
TaskServicetaskservice = processEngine.getTaskService();
4、HistoryService:
HistoryService是activiti的查询历史信息的类。在一个流程执行完成后，这个对象为我们提供查询历史信息。
HistoryServicehistoryService = processEngine.getHistoryService();
九、部署流程
1. 使用文件部署
1 /**部署流程定义*/ 2 @Test 3 public void deploymentProcessDefinition_classpath(){ 4 Deployment deployment = processEngine.getRepositoryService() // 与流程定义和部署对象相关的Service 5 .createDeployment() // 创建一个部署对象 6 .name("流程定义") // 设置对应流程的名称 7 .addClasspathResource("diagrams/helloworld.bpmn") // 从Classpath的资源中加载，一次只能加载一个文件(windows与linux下面要区分) 8 .addClasspathResource("diagrams/helloworld.bpmn") // 从Classpath的资源中加载，图片 9 .deploy(); // 完成部署 10 11 System.out.println("部署Id："+deployment.getId()); // 部署Id：20001 12 System.out.println("部署名称："+deployment.getName()); // 部署名称：流程定义 13 }
2. 使用流程定义zip文件部署
1 /**部署流程定义zip文件*/ 2 @Test 3 public void deploymentProcessDefinition_zip(){ 4 InputStream in = this.getClass().getClassLoader().getResourceAsStream("zip/helloworld.zip"); 5 ZipInputStream zipInputStream = new ZipInputStream(in); 6 Deployment deployment = processEngine.getRepositoryService() // 与流程定义和部署对象相关的Service 7 .createDeployment() // 创建一个部署对象 8 .name("zip流程定义") // 添加部署的名称 9 .addZipInputStream(zipInputStream) // 制定zip格式文件完成部署 10 .deploy(); // 完成部署 11 System.out.println("部署Id："+deployment.getId()); // 部署Id:22501 12 System.out.println("部署名称："+deployment.getName()); // 部署名称:zip流程定义 13 }
3. 使用输入流部署：
1 /**部署流程定义zip文件*/ 2 @Test 3 public void deploymentProcessDefinition_inputStream(){ 4 InputStream inputStreambpmn = this.getClass().getResourceAsStream("/diagrams/processVariables.bpmn"); 5 InputStream inputStreampng = this.getClass().getResourceAsStream("/diagrams/processVariables.png"); 6 7 8 Deployment deployment = processEngine.getRepositoryService() // 与流程定义和部署对象相关的Service 9 .createDeployment() // 创建一个部署对象 10 .name("流程定义输入流") // 添加部署的名称 11 .addInputStream("processVariables.bpmn", inputStreambpmn)// 使用资源文件名称（要求与资源文件的名称要一致），和输入流完成部署 12 .addInputStream("processVariables.png", inputStreampng)// 使用资源文件名称（要求与资源文件的名称要一致），和输入流完成部署 13 .deploy(); // 完成部署 14 System.out.println("部署Id："+deployment.getId()); // 部署Id:55001 15 System.out.println("部署名称："+deployment.getName()); // 部署名称:流程定义输入流 16 }
十. 启动流程实例：
1. 什么是流程实例：就是一个活生生的流程、流程定义是定义了这一类的流程是如何的，而流程实例就是真正的业务流程。一切操作的基础都基于流程实例
2. 启动流程实例：
1 /** 启动流程实例 */ 2 @Test 3 public void startProcessInstance(){ 4 String processDefinitionKey = "psocessVariables"; // 使用Key的启动，默认按照对心版本的流程定义启动 5 ProcessInstance pi = processEngine.getRuntimeService() // 与正在执行的流程实例和执行对象相关的Service 6 .startProcessInstanceByKey(processDefinitionKey); // 使用流程定义的Key启动流程实例，key对应helloworld.bpmn文件中的流程名称 7 8 System.out.println("流程实例Id"+pi.getId()); // 流程实例Id：57501 9 System.out.println("流程定义Id"+pi.getProcessDefinitionId()); // 流程定义Id：psocessVariables:1:55004 10 }
