OA工作流-Activiti(一)-阿里云开发者社区

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);
  }

OA工作流-Activiti(一)

activiti.cfg.xml（activiti的配置文件）

4.4：TaskService

4.5：HistoryService

4.6：ProcessDefinition

4.7：ProcessInstance

热门文章

最新文章

相关课程

相关电子书

热门

活动广场

任务中心

开发者评测

高校计划

乘风者计划

训练营

阿里云MVP

话题

直播

下载

镜像站

技术资料

插件

OA工作流-Activiti(一)

activiti.cfg.xml（activiti的配置文件）

4.4：TaskService

4.5：HistoryService

4.6：ProcessDefinition

4.7：ProcessInstance

热门文章

最新文章

相关课程

相关电子书