Activiti工作流在开发中的应用

Activiti框架简介

Activiti5是由Alfresco软件在2010年5月17日发布的业务流程管理（BPM）框架，它是覆盖了业务流程管理、工作流、服务协作等领域的一个开源的、灵活的、易扩展的可执行流程语言框架。Activiti基于Apache许可的开源BPM平台，创始人Tom Baeyens是JBoss JBPM的项目架构师，它的特色是提供了eclipse插件，开发人员可以通过插件直接绘画出业务流程图。 

简单工作流的搭建与部署

idea安装actiBPM插件

方式一:File->Settings->Plugins->Browse repositories 搜索actiBPM双击或点Install安装

方法二: 访问 http://plugins.jetbrains.com/plugin/7429-actibpm 下载actiBPM插件

然后File->Settings->Plugins->Install plugins from disk 进行本地安装

注:eclipse插件下载: http://activiti.org/designer/update/ 

解决bpmn文件乱码问题

修改idea安装目录下lib文件夹下的"idea.exe.vmoptions"或"idea64.exe.vmoptions"文件,具体根据安装电脑系统定,在文件下追加 -Dfile.encoding=UTF-8,保存后重启idea

生成bpmn文件

新建maven项目,pom.xml加入相关约束

<dependencies>
    <!--JUnit测试-->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
    </dependency>
    <!--- Activiti依赖导入 -->
    <dependency>
        <groupId>org.activiti</groupId>
        <artifactId>activiti-spring</artifactId>
        <version>5.18.0</version>
    </dependency>
    <dependency>
        <groupId>org.activiti</groupId>
        <artifactId>activiti-engine</artifactId>
        <version>5.18.0</version>
        <exclusions>
            <exclusion>
                <artifactId>slf4j-api</artifactId>
                <groupId>org.slf4j</groupId>
            </exclusion>
            <exclusion>
                <artifactId>spring-beans</artifactId>
                <groupId>org.springframework</groupId>
            </exclusion>
            <exclusion>
                <artifactId>jackson-core-asl</artifactId>
                <groupId>org.codehaus.jackson</groupId>
            </exclusion>
            <exclusion>
                <artifactId>commons-lang3</artifactId>
                <groupId>org.apache.commons</groupId>
            </exclusion>
            <exclusion>
                <artifactId>commons-lang3</artifactId>
                <groupId>org.apache.commons</groupId>
            </exclusion>
        </exclusions>
    </dependency>
    <!--MySQL 驱动包，如果是其他库的话需要换驱动包-->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.35</version>
    </dependency>
</dependencies>

在java的resource目录下，点击New，选择BpmnFile，创建bpmn文件

双击创建的文件,显示如下界面,并通过拖拽完成简单工作流程(连接线需要悬停在对应元素上通过拖拽中心点来产生.)

点击元素,在这里修改两个属性，Name和Assignee。 

name:工作步骤名 Assignee:代理人,做工的人(这里写emp和manager)

部署及简单运行工作流， 创建activiti.cfg.xml配置文件

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans   http://www.springframework.org/schema/beans/spring-beans.xsd">
    <bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
        <property name="jdbcUrl" value="jdbc:mysql://127.0.0.1:3306/activiti" />
        <property name="jdbcDriver" value="com.mysql.jdbc.Driver" />
        <property name="jdbcUsername" value="root" />
        <property name="jdbcPassword" value="root" />
        <property name="databaseSchemaUpdate" value="true" />
    </bean>
</beans>

创建Activiti类,并测试

package com.zp;
import org.activiti.engine.*;
import org.activiti.engine.repository.DeploymentBuilder;
import org.activiti.engine.task.Task;
import org.junit.Test;
import java.util.List;
public class LeaveActivitiTest {
    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
    @Test
    public void test() {
        //以下两种方式选择一种创建引擎方式：1.配置写在程序里 2.读对应的配置文件 二选一即可,数据库生成表
        testCreateProcessEngine();//1
        testCreateProcessEngineByCfgXml(); //2
        deployProcess();
        startProcess();
        queryTask();
        //根据上一步生成的taskId执行任务执行下面方法,否则报错
        //handleTask();
    }

    //测试activiti环境
    @Test
    public void testCreateProcessEngine() {
        ProcessEngineConfiguration cfg = ProcessEngineConfiguration.createStandaloneProcessEngineConfiguration();
        cfg.setJdbcDriver("com.mysql.jdbc.Driver");
        cfg.setJdbcUrl("jdbc:mysql://127.0.0.1:3306/activiti");
        cfg.setJdbcUsername("root");
        cfg.setJdbcPassword("root");
        //配置建表策略
        cfg.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);
        ProcessEngine engine = cfg.buildProcessEngine();
    }
    // 根据配置文件activiti.cfg.xml创建ProcessEngine
    @Test
    public void testCreateProcessEngineByCfgXml() {
        ProcessEngineConfiguration cfg = ProcessEngineConfiguration.createProcessEngineConfigurationFromResource("activiti.cfg.xml");
        ProcessEngine engine = cfg.buildProcessEngine();
    }
    //发布流程
    @Test
    public void deployProcess() {
        RepositoryService repositoryService = processEngine.getRepositoryService();
        DeploymentBuilder builder = repositoryService.createDeployment();
        builder.addClasspathResource("mybpmn.bpmn");
        builder.deploy();
    }
    //启动流程
    @Test
    public void startProcess() {
        RuntimeService runtimeService = processEngine.getRuntimeService();
        //可根据id、key、message启动流程
        runtimeService.startProcessInstanceByKey("myProcess_1");
    }
    //查看任务
    @Test
    public void queryTask() {
        TaskService taskService = processEngine.getTaskService();
        //根据assignee(代理人)查询任务
        String assignee = "emp";
        List<Task> tasks = taskService.createTaskQuery().taskAssignee(assignee).list();
        int size = tasks.size();
        for (int i = 0; i < size; i++) {
            Task task = tasks.get(i);
        }
        for (Task task : tasks) {
            System.out.println("taskId:" + task.getId() +
                    ",taskName:" + task.getName() +
                    ",assignee:" + task.getAssignee() +
                    ",createTime:" + task.getCreateTime());
        }
    }
     //办理任务
    @Test
    public void handleTask() {
        TaskService taskService = processEngine.getTaskService();
        //根据上一步生成的taskId执行任务
        String taskId = "10008";
        taskService.complete(taskId);
    }
}

Activiti的api详解

ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();

(1) RepositoryService 

是Activiti的仓库服务类。所谓的仓库指流程定义文档的两个文件：bpmn文件和流程图片。

//产出方式 //流程定义和部署对象相关的service
RepositoryService repositoryService = processEngine.getRepositoryService()
// 可以产生DeploymentBuilder，用来定义流程部署的相关参数
DeploymentBuilder builder = repositoryService.createDeployment();
//删除流程定义
repositoryService.deleteDeployment("deploymentId");

(2)  RuntimeService  流程服务类

RuntimeService runtimeService = processEngine.getRuntimeService();
//启动流程实例
runtimeService.startProcessInstanceByKey("流程key值");
// 查看流程是否结束
ProcessInstance processInstance = runtimeService//正在执行的流程
.createProcessInstanceQuery()//创建流程实例查询对象
.processInstanceId("流程实例ID")
.singleResult();
//如果为空，流程已结束
if(processInstance==null){
System.out.println("流程已结束");
}else{
System.out.println("流程未结束");
}

(3) TaskService  任务服务类

TaskService taskService = processEngine.getTaskService();
// 查询任务
List<Task> list = taskService//与正在执行任务相关的service
.createTaskQuery()//创建任务查询对象
.taskAssignee("当前处理人")
.list();
// 完成任务
taskService.complete("108");

(4)  HistoryService  关于历史数据查询

HistoryService historyService= processEngine.getHistoryService();
// 查询历史流程实例
String processInstanceId = "2101";
HistoricProcessInstance hpi = historyService//与历史数据（历史表）相关的Service
.createHistoricProcessInstanceQuery()//创建历史流程实例查询
.processInstanceId(processInstanceId)//使用流程实例ID查询
.orderByProcessInstanceStartTime().asc()
.singleResult();
// 查询历史活动
List<HistoricActivityInstance> list = phistoryService//
.createHistoricActivityInstanceQuery()//创建历史活动实例的查询
.processInstanceId(processInstanceId)//
.orderByHistoricActivityInstanceStartTime().asc()//
.list();
//查询历史任务
List<HistoricTaskInstance> list = phistoryService//与历史数据（历史表）相关的Service
.createHistoricTaskInstanceQuery()//创建历史任务实例查询
.processInstanceId(processInstanceId)//
.orderByHistoricTaskInstanceStartTime().asc()
.list();
// 查询历史流程变量
List<HistoricVariableInstance> list =phistoryService//
.createHistoricVariableInstanceQuery()//创建一个历史的流程变量查询对象
.processInstanceId(processInstanceId)//
.list();

(5) IdentityService 关于组织机构的查询

IdentityService identityService = processEngine.getIdentityService();//认证：保存组和用户信息
//就是组织管理系，这里面很少用Activiti，因为提供的字段太少，一般的项目中会自己维护一套组织机构的关系表。
identityService.saveGroup(new GroupEntity("部门经理"));//建立组
identityService.saveGroup(new GroupEntity("总经理"));//建立组
identityService.saveUser(new UserEntity(“小张”));//建立用户
identityService.saveUser(new UserEntity("小李")); //建立用户
identityService.saveUser(new UserEntity("小王")); //建立用户
identityService.createMembership("小张", "部门经理");//建立组和用户关系
identityService.createMembership("小李", "部门经理");//建立组和用户关系