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></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张表*/

 @Testpublic 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张表*/

   @Testpublic 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();/**部署流程定义*/@Testpublic 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());//1System.out.println("部署名称："+deployment.getName());//helloworld入门程序  }

5.3 启动流程

 /**启动流程实例*/@Testpublic void startProcessInstance(){//流程定义的keyString processDefinitionKey = "helloworld";ProcessInstance pi = processEngine.getRuntimeService()//与正在执行的流程实例和执行对象相关的Service.startProcessInstanceByKey(processDefinitionKey);//使用流程定义的key启动流程实例，key对应helloworld.bpmn文件中id的属性值，使用key值启动，默认是按照最新版本的流程定义启动System.out.println("流程实例ID:"+pi.getId());//流程实例ID    101System.out.println("流程定义ID:"+pi.getProcessDefinitionId());//流程定义ID   helloworld:1:4}

5.4查询当前任务

/**查询当前人的个人任务*/@Testpublic 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完成当前任务

/**完成我的任务*/@Testpublic void completeMyPersonalTask(){//任务IDString taskId = "302";processEngine.getTaskService()//与正在执行的任务管理相关的Service.complete(taskId);System.out.println("完成任务：任务ID："+taskId);}

不懂的可以在下面评论

欢迎订阅关注公众号（JAVA和人工智能）

获取更多免费书籍、资源、视频资料