OA工作流-Activiti(一)
一、工作流定义
工作流：一系列相互衔接、自动进行的业务活动或任务。
OA工作流：建立于网络办公自动化基础上的事务行政审批，业务申请审批、公文、信息等的网上流转。它主要解决的是“使在多个参与者之间按照某种预定义的规则传递文档、信息或任务的过程自动进行，从而实现某个预期的业务目标，或者促使此目标的实现”。
不同于以往我们在仅仅进行增删改查（CRUD），我们还要对其进行 下订单--订单确认--财务收款--库管配货--运送 等等一系列操作。
工作流管理系统(Workflow Management System, 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）
数据库（流程数据24张表）：
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用户信息表
通用数据表：
1) act_ge_bytearray二进制数据表
2) act_ge_property属性数据表存储整个流程引擎级别的数据,初始化表结构时，会默认插入三条记录，
activiti.cfg.xml（activiti的配置文件）
Activiti核心配置文件，配置流程引擎创建工具的基本参数和数据库连接池参数。
定义数据库配置参数：
l jdbcUrl: 数据库的JDBC URL。
l jdbcDriver: 对应不同数据库类型的驱动。
l jdbcUsername: 连接数据库的用户名。
l jdbcPassword: 连接数据库的密码。
基于JDBC参数配置的数据库连接 会使用默认的MyBatis连接池。 下面的参数可以用来配置连接池（来自MyBatis参数）：
l jdbcMaxActiveConnections: 连接池中处于被使用状态的连接的最大值。默认为10。
l jdbcMaxIdleConnections: 连接池中处于空闲状态的连接的最大值。
l jdbcMaxCheckoutTime: 连接被取出使用的最长时间，超过时间会被强制回收。 默认为20000（20秒）。
l jdbcMaxWaitTime: 这是一个底层配置，让连接池可以在长时间无法获得连接时， 打印一条日志，并重新尝试获取一个连接。（避免因为错误配置导致沉默的操作失败）。 默认为20000（20秒）。
<bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration"> <!-- 连接数据的配置 --> <property name="jdbcDriver" value="com.mysql.jdbc.Driver"></property> <property name="jdbcUrl" value="jdbc:mysql://localhost:3306/itcast0711activiti?useUnicode=true&characterEncoding=utf8"></property> <property name="jdbcUsername" value="root"></property> <property name="jdbcPassword" value="root"></property> <!-- 没有表创建表 --> <property name="databaseSchemaUpdate" value="true"></property> 9 </bean>
注意：
1，流程数据需要24张表，全部都是Activiti的底层表，默认使用MyBatis进行操作。
2，工作流的表仅仅是用来进行存放流程数据的，而业务数据需要自己创建和维护，一定要自己进行关联表（业务和流程表）
三、准备环境
3.1activiti5 软件环境
1) JDK1.6+
2) 支持的数据库有：h2, mysql, oracle, postgres, mssql, db2等。
3) 支持activiti5运行的jar包
4) 开发环境为Eclipse3.7+,myeclipse为8.6+
3.2相关资源下载
Activiti官方网站：http://activiti.org/download.html
其他资源到相关网站去下载即可。
3.3安装流程
3.3.1安装方式一
1) 打开 Help -> Install New Software. 在如下面板中:
2) 在如下Install界面板中，点击Add按钮：配置新装插件的地址和名称
3) 然后填入下列字段
Name: Activiti BPMN 2.0 designer
Location: http://activiti.org/designer/update/
4) 回到Install界面，把所有展示出来的项目都勾上： 
5) 点击next完成安装，安装完以后，点击新建工程new->Other…打开面板，如果看到下图内容：
3.3.2安装方式2：
1，http://www.activiti.org/designer/archived/ 下载
解压
2，打开eclipse根目录diopins文件夹将内容放进去
3，重启eclipse new-others查看信息
3.4流程设计器的使用说明
菜单Windows->Preferences->Activiti->Save
打上勾后Activiti画图工具会在流程文件保存时自动生成一张流程图
完成上面的配置之后由我们自己来管理流程图片。
3.5activiti开发环境配置
3.5.1添加jar包 建立
新建maven工程，加入在pom文件中加入指定jar
<properties> <activiti-version>5.11</activiti-version> </properties> <dependencies> <dependency> <groupId>org.activiti</groupId> <artifactId>activiti-engine</artifactId> <version>${activiti-version}</version> </dependency> <dependency> <groupId>org.activiti</groupId> <artifactId>activiti-spring</artifactId> <version>${activiti-version}</version> </dependency> <dependency> <groupId>org.codehaus.groovy</groupId> <artifactId>groovy-all</artifactId> <version>2.0.4</version> </dependency> <dependency> <groupId>com.h2database</groupId> <artifactId>h2</artifactId> <version>1.3.168</version> </dependency> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.8.1</version> </dependency> </dependencies> <repositories> <repository> <id>Activiti</id> <url>http://maven.alfresco.com/nexus/content/repositories/activiti</url> </repository> </repositories> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>2.3.2</version> <configuration> <source>1.6</source> <target>1.6</target> </configuration> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-eclipse-plugin</artifactId> <inherited>true</inherited> <configuration> <classpathContainers> <classpathContainer>org.eclipse.jdt.USER_LIBRARY/Activiti Designer Extensions</classpathContainer> </classpathContainers> </configuration> </plugin> </plugins> </build> </project>
3.5.2 使用Test类测试
写一个Test类，调用里面自带的方法可以自动生成24张表
/**使用代码创建工作流需要的23张表*/
@Test public void createTable(){ ProcessEngineConfiguration processEngineConfiguration = ProcessEngineConfiguration.createStandaloneProcessEngineConfiguration(); //连接数据库的配置 processEngineConfiguration.setJdbcDriver("com.mysql.jdbc.Driver"); processEngineConfiguration.setJdbcUrl("jdbc:mysql://localhost:3306/itcast0711activiti?useUnicode=true&characterEncoding=utf8"); processEngineConfiguration.setJdbcUsername("root"); processEngineConfiguration.setJdbcPassword("root"); /** public static final String DB_SCHEMA_UPDATE_FALSE = "false";不能自动创建表，需要表存在 public static final String DB_SCHEMA_UPDATE_CREATE_DROP = "create-drop";先删除表再创建表 public static final String DB_SCHEMA_UPDATE_TRUE = "true";如果表不存在，自动创建表 */ processEngineConfiguration.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE); //工作流的核心对象，ProcessEnginee对象 ProcessEngine processEngine = processEngineConfiguration.buildProcessEngine(); System.out.println("processEngine:"+processEngine); }
3.5.3使用配置文件activiti.cfg.xml
配置如下：
<bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration"> <!-- 连接数据的配置 --> <property name="jdbcDriver" value="com.mysql.jdbc.Driver"></property> <property name="jdbcUrl" value="jdbc:mysql://localhost:3306/itcast0711activiti?useUnicode=true&characterEncoding=utf8"></property> <property name="jdbcUsername" value="root"></property> <property name="jdbcPassword" value="root"></property> <!-- 没有表创建表 --> <property name="databaseSchemaUpdate" value="true"></property> </bean>
写测试类Test2
/**使用配置文件创建工作流需要的23张表*/
@Test public void createTable_2(){ // ProcessEngineConfiguration processEngineConfiguration = ProcessEngineConfiguration.createProcessEngineConfigurationFromResource("activiti.cfg.xml"); // //工作流的核心对象，ProcessEnginee对象 // ProcessEngine processEngine = processEngineConfiguration.buildProcessEngine(); ProcessEngine processEngine = ProcessEngineConfiguration.createProcessEngineConfigurationFromResource("activiti.cfg.xml") // .buildProcessEngine(); System.out.println("processEngine:"+processEngine); }
3.5.4添加log4.j
log4j.rootLogger=WARN, CA # ConsoleAppender log4j.appender.CA=org.apache.log4j.ConsoleAppender log4j.appender.CA.layout=org.apache.log4j.PatternLayout log4j.appender.CA.layout.ConversionPattern= %d{hh:mm:ss,SSS} [%t] %-5p %c %x - %m%n
四、核心API
4.1 ProcessEngine --在Activiti中最核心的类，其他的类都是由他而来
调用ProcessEngines的getDefaultProceeEngine方法时会自动加载classpath下名为activiti.cfg.xml文件
通过get方法就可以获取各个service
例:
各个Service的作用：
4.2 RepositoryService
是Activiti的仓库服务类。所谓的仓库指流程定义文档的两个文件：bpmn文件和流程图片。
4.3 RuntimeService
是activiti的流程执行服务类。可以从这个服务类中获取很多关于流程执行相关的信息。
4.4：TaskService
是activiti的任务服务类。可以从这个类中获取任务的信息。
4.5：HistoryService
是activiti的查询历史信息的类。在一个流程执行完成后，这个对象为我们提供查询历史信息。
4.6：ProcessDefinition
流程定义类。可以从这里获得资源文件等。
4.7：ProcessInstance
代表流程定义的执行实例。如范冰冰请了一天的假，她就必须发出一个流程实例的申请。一个流程实例包括了所有的运行节点。我们可以利用这个对象来了解当前流程实例的进度等信息。流程实例就表示一个流程从开始到结束的最大的流程分支，即一个流程中流程实例只有一个。
4.8Execution
Activiti用这个对象去描述流程执行的每一个节点。在没有并发的情况下，Execution就是同ProcessInstance。流程按照流程定义的规则执行一次的过程，就可以表示执行对象Execution。
* 一个流程中，执行对象可以存在多个，但是流程实例只能有一个。
* 当流程按照规则只执行一次的时候，那么流程实例就是执行对象。
五、模拟流程的执行
5.1进行下面流程的Test测试！！
通过Activiti Diagram创建流程图
5.2部署流程定义
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine(); /**部署流程定义*/ @Test public void deploymentProcessDefinition(){ Deployment deployment = processEngine.getRepositoryService()//与流程定义和部署对象相关的Service .createDeployment()//创建一个部署对象 .name("helloworld入门程序")//添加部署的名称 .addClasspathResource("diagrams/helloworld.bpmn")//从classpath的资源中加载，一次只能加载一个文件 .addClasspathResource("diagrams/helloworld.png")//从classpath的资源中加载，一次只能加载一个文件 .deploy();//完成部署 System.out.println("部署ID："+deployment.getId());//1 System.out.println("部署名称："+deployment.getName());//helloworld入门程序 }
5.3 启动流程
/**启动流程实例*/ @Test public void startProcessInstance(){ //流程定义的key String processDefinitionKey = "helloworld"; ProcessInstance pi = processEngine.getRuntimeService()//与正在执行的流程实例和执行对象相关的Service .startProcessInstanceByKey(processDefinitionKey);//使用流程定义的key启动流程实例，key对应helloworld.bpmn文件中id的属性值，使用key值启动，默认是按照最新版本的流程定义启动 System.out.println("流程实例ID:"+pi.getId());//流程实例ID 101 System.out.println("流程定义ID:"+pi.getProcessDefinitionId());//流程定义ID helloworld:1:4 }
5.4查询当前任务
/**查询当前人的个人任务*/ @Test public void findMyPersonalTask(){ String assignee = "王五"; List<Task> list = processEngine.getTaskService()//与正在执行的任务管理相关的Service .createTaskQuery()//创建任务查询对象 .taskAssignee(assignee)//指定个人任务查询，指定办理人 .list(); if(list!=null && list.size()>0){ for(Task task:list){ System.out.println("任务ID:"+task.getId()); System.out.println("任务名称:"+task.getName()); System.out.println("任务的创建时间:"+task.getCreateTime()); System.out.println("任务的办理人:"+task.getAssignee()); System.out.println("流程实例ID："+task.getProcessInstanceId()); System.out.println("执行对象ID:"+task.getExecutionId()); System.out.println("流程定义ID:"+task.getProcessDefinitionId()); System.out.println("########################################################"); } } }
5.5完成当前任务
/**完成我的任务*/ @Test public void completeMyPersonalTask(){ //任务ID String taskId = "302"; processEngine.getTaskService()//与正在执行的任务管理相关的Service .complete(taskId); System.out.println("完成任务：任务ID："+taskId); }
