Activiti框架学习记录-01

本篇主要是Activiti工作流框架的学习记录，以及对于该框架的基本使用和一些浅显的理解：

• 1、工作流框架基本概念
• 2、在eclipse中使用工作流框架
• 3、创建工作框架
• 4、使用框架提供API，操作框架实现业务逻辑

1、工作流框架基本概念（摘自百度百科）

• 工作流(Workflow)，就是“业务过程的部分或整体在计算机应用环境下的自动化”，它主要解决的是“使在多个参与者之间按照某种预定义的规则传递文档、信息或任务的过程自动进行，从而实现某个预期的业务目标，或者促使此目标的实现”。
• 工作流管理系统(Workflow Management System, WfMS)是一个软件系统，它完成工作量的定义和管理，并按照在系统中预先定义好的工作流逻辑进行工作流实例的执行。工作流管理系统不是企业的业务系统，而是为企业的业务系统的运行提供了一个软件的支撑环境。
• 常见的工作流框架：JBPM4.4、activiti5.13、OSWorkFlow；

2、在eclipse中使用工作流框架

1、可以离线安装插件，将activit文件夹拷贝到eclipse-luna的安装目录下的
盘符:\Eclipse\eclipse_luna\dropins\ 文件夹下，重启eclipse，进入eclipse后再Window下preference中出现Acitviti选项为安装插件成功，如下图1所示：

并且勾选create process definition image when saving the diagram，这样在我们保存一个流程的时候同时会保存一张png图片；

2、可以选择在线安装：
Name：Activiti BPMN 2.0 designer
Location：http://activiti.org/designer/update/；
等待一会儿安装成功后操作以及界面同1所示；
当我们需要使用的时候，点击new->others，如下图2所示：

3、创建工作框架

• 1、建立表结构（两种方式）；
• 2、初步分析23张表的结构与意义；
• 3、框架中表的设计结构；

知识点分析1：表结构的建立
1）利用sql文件创建表，在我们activiti框架的目录：
…\activiti-5.13\database\create\

执行sql文件，进入mysql命令行：

source E:\activiti-5.13\database\create\activiti.mysql.create.engine.sql
source E:\activiti-5.13\database\create\activiti.mysql.create.history.sql
source E:\activiti-5.13\database\create\activiti.mysql.create.identity.sql

2）利用API创建表
步骤一：配置文件，使用默认的配置文件：文件必须在类路径下，名称必须为activiti-context.xml
文件中bean的ID规定好的

<!-- activiti-context.xml 配置文件代码-->
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:context="http://www.springframework.org/schema/context" xmlns:tx="http://www.springframework.org/schema/tx"
    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
                        http://www.springframework.org/schema/context 
                        http://www.springframework.org/schema/context/spring-context-2.5.xsd
                        http://www.springframework.org/schema/tx 
                        http://www.springframework.org/schema/tx/spring-tx-3.0.xsd">

    <!-- 配置流程引擎配置对象  activiti-day01 -->
    <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:///activiti-demo01"></property>
        <property name="jdbcUsername" value="root" ></property>
        <property name="jdbcPassword" value="root"></property>
        <!-- 注入自动建表设置 -->
        <property name="databaseSchemaUpdate" value="true"></property>
    </bean>

    <!-- 提供工厂bean，创建流程引擎对象 -->
    <bean id="processEngine" class="org.activiti.spring.ProcessEngineFactoryBean">
        <property name="processEngineConfiguration" ref="processEngineConfiguration"></property>
    </bean>
</beans>

//Java代码片段-01-使用配置文件
@Test
public void test() {
//使用的是默认文件的创建规则
ProcessEngine processEngine = 
ProcessEngines.getDefaultProcessEngine();
}

//Java代码片段-02-不使用配置文件
//使用activit框架提供的自动创建表的方式创建23张表
    /**
     * 自动建表的方式
     */
    @SuppressWarnings("unused")
    @Test
    public void test1() {
        //创建一个流程引擎配置对象
        ProcessEngineConfiguration configuration = 
                ProcessEngineConfiguration.createStandaloneProcessEngineConfiguration();
        //设置数据源信息
        configuration.setJdbcDriver("com.mysql.jdbc.Driver");
        configuration.setJdbcUrl("jdbc:mysql:///activiti-day01");
        configuration.setJdbcUsername("root");
        configuration.setJdbcPassword("1234");
        //设置自动建表的操作
        configuration.setDatabaseSchemaUpdate("true");
        //使用配置对象创建一个流程引擎对象
        ProcessEngine processEngine = configuration.buildProcessEngine();
    }

知识点分析2：初步分析23张表的结构与意义
Activiti的后台是有数据库的支持，所有的表都以ACT_开头。 第二部分是表示表的用途的两个字母标识。 用途也和服务的API对应。

• ACT_RE_*: ‘RE’表示repository。 这个前缀的表包含了流程定义和流程静态资源 （图片，规则，等等）。

• ACT_RU_*: ‘RU’表示runtime。 这些运行时的表，包含流程实例，任务，变量，异步任务，等运行中的数据。 Activiti只在流程实例执行过程中保存这些数据， 在流程结束时就会删除这些记录。 这样运行时表可以一直很小速度很快。

• ACT_ID_*: ‘ID’表示identity。 这些表包含身份信息，比如用户，组等等。

• ACT_HI_*: ‘HI’表示history。 这些表包含历史数据，比如历史流程实例， 变量，任务等等。 ACT_GE_*: 通用数据， 用于不同场景下。

知识点分析3：初步分析23张表的结构与意义
Activiti的后台是有数据库中表的设计结构：

4、使用API操作工作流框架

初步模拟 流程　使用代码片段如下：

1、画图：画出流程图

2、部署流程

1）部署流程定义

  /**
   * 初步模拟一个请假流程
   * 1、部署流程定义
   * 意义：将设计流程图插入到数据库中
   */
    @Test
    public void test4() {
        //流程部署定义
        //部署构建器，用于加载流程定义文件，部署流程定义
        DeploymentBuilder deploymentBuilder = 
                processEngine.getRepositoryService().createDeployment();
        //加载流程定义文件（bpmn、png）
        deploymentBuilder.addClasspathResource("demo01.bpmn");
        deploymentBuilder.addClasspathResource("demo01.png");
        //返回部署对象
        Deployment deployment = deploymentBuilder.deploy();
        //常看当前的流程部署ID
        System.out.println(deployment.getId());
    }

2）查询流程定义

    // 查询流程定义
    @Test
    public void test5() {
        //流程定义查询对象，操作的数据表act_re_prodef
        ProcessDefinitionQuery query = 
                processEngine.getRepositoryService().createProcessDefinitionQuery();
        //查询到流程定义（流程定义表的而查询）
        //可以添加过滤条件
        query.processDefinitionNameLike("请假流程");
        //添加排序条件
        query.orderByProcessDefinitionVersion().desc();

        List<ProcessDefinition> list = 
                query.listPage(0, 1); // 分页查询

        //流程定义对象的遍历
        for (ProcessDefinition processDefinition : list) {
            String id   = processDefinition.getId();
            String name = processDefinition.getName();
            int version = processDefinition.getVersion();
            String deploymentId = processDefinition.getDeploymentId();
            String resourceName = processDefinition.getResourceName();
            System.out.println(id + "\t" + name + "\t" + version);
            System.out.println(deploymentId + "\t" + resourceName);
        }
    }

3）根据流程定义的ID查询实例

    // act_ac_execution：存放的当前启动的实例信息
    // act_ru_task: 存放当前产生的任务（整个流程向下推进十分重要）
    @Test
    public void test6() {
        String processDefinitionId = "qjlc:4:304"; //流程定义ID自己根据数据库表中数据修改
        ProcessInstance processInstance = 
                processEngine.getRuntimeService().startProcessInstanceById(processDefinitionId);
        System.out.println(processInstance.getId());
    }

4）查询个人任务行为

    @Test
    public void test7() {
        //任务查询对象，查询任务表
        TaskQuery query = 
                processEngine.getTaskService().createTaskQuery();
        //添加过滤条件，根据任务的办理人过滤
        query.taskAssignee("张三");
        List<Task> list = query.list();
        for (Task task : list) {
            System.out.println(task.getId() + "====" + task.getName());
        }
    } 

4）办理个人任务行为

    @Test
    public void test8() {
        String taskId = "1804"; // 任务ID，根据数据库中task表中的数据进行修改
        //自动推向到下一个任务人
        processEngine.getTaskService().complete(taskId);
    }

5）清理数据库activiti表中的所有数据

    @Test
    public void test() {
        DeploymentQuery query = processEngine.getRepositoryService().createDeploymentQuery();
        List<Deployment> list = query.list();
        for (Deployment deployment : list) {
            //完全清理数据，级联清理数据
            processEngine.getRepositoryService().deleteDeployment(deployment.getId(), true);
        }
    }

流程实例的操作（代码为了保证完整性的功能与上述代码功能会有部分重复）
1）首先声明一个流程操作引擎，基本在整个框架的声明周期中都会有所使用

//在项目中可以使用spring的注入技术进行处理，现在暂时使用普通方法
ProcessEngine pe = ProcessEngines.getDefaultProcessEngine();

2）部署流程定义
* 方式一：加载单个的流程定义文件
* 方式二：加载zip压缩文件（将bpmn文件以及png文件进行打包为process.zip）

@Test
    public void test1() {
        DeploymentBuilder deploymentBuilder = 
                pe.getRepositoryService().createDeployment();
//      ZipInputStream zipInputStream_file = null;
        // 方式一：加载单个流程定义文件
//      deploymentBuilder.addClasspathResource("demo01.bpmn");
//      deploymentBuilder.addClasspathResource("demo01.png");
//      Deployment deployment = deploymentBuilder.deploy();

        // 方式二：加载zip压缩文件PS： 只支持zip
        // Web项目中使用该方式
//      try {
//          zipInputStream_file = new ZipInputStream(new FileInputStream(new File("d:\\process.zip")));
//      } catch (FileNotFoundException e) {
//          // TODO Auto-generated catch block
//          e.printStackTrace();
//      }
        ZipInputStream zipInputStream 
            = new ZipInputStream(this.getClass().getClassLoader().getResourceAsStream("process.zip"));
        deploymentBuilder.addZipInputStream(zipInputStream);
        deploymentBuilder.name("部署名称测试");
        Deployment deployment = deploymentBuilder.deploy();
        String id = deployment.getId();
        System.out.println(id);
    }

3）查询部署信息，查询的通用写法

      pe.getXXXService().createXXXQuery().list()

@Test
    public void test2() {
//      pe.getRepositoryService().createDeploymentQuery().list();
//      pe.getRepositoryService().createProcessDefinitionQuery().list();
//      pe.getRuntimeService().createProcessInstanceQuery().list();
//      pe.getTaskService().createTaskQuery().list();
//      pe.getHistoryService().createHistoricActivityInstanceQuery().list();

        List<Deployment> list = pe.getRepositoryService().createDeploymentQuery().list();
        for (Deployment deployment : list) {
            System.out.println(deployment.getId() + "\t" + deployment.getDeploymentTime());
        }

    }

3）删除部署信息

    // 删除部署信息
    @Test
    public void test3() {
        //删除deploymentId为501的部署信息数据，同样会影响几张表
        String deploymentId = "501";
        //是否级联删除(会删除更多的表)
        boolean cascade = true;
        pe.getRepositoryService().deleteDeployment(deploymentId,cascade);
    }

3）查询流程定义数据

@Test
    public void test4() {
        List<ProcessDefinition> list = pe.getRepositoryService().createProcessDefinitionQuery().list();
        for (ProcessDefinition processDefinition : list) {
            System.out.println(processDefinition.getId() + "\t" + 
                    processDefinition.getKey() + "\t" + 
                    processDefinition.getResourceName() + "\t" + 
                    processDefinition.getVersion());
        }
    }

4） 删除流程定义数据,通过删除部署信息达到删除流程定义的目的

@Test
    public void test5() {
        //删除部署的时候会自动删除流程定义
        String deploymentId = "501";
        pe.getRepositoryService().deleteDeployment(deploymentId);
    }

5）查询相关

    /**
     * 查询最新版本的流程定义数据
     */
    @Test
    public void test6() {
        //查询的是所有的
        pe.getRepositoryService().createDeploymentQuery().list();
        //查询最新的
        List<ProcessDefinition> list = pe.getRepositoryService().createProcessDefinitionQuery().latestVersion().list();
        for (ProcessDefinition processDefinition : list) {
            System.out.println(processDefinition.getVersion() + "\t" + processDefinition.getDeploymentId());
        }
    }

    @Test
    public void test7() {
        //没有提供过滤条件就需要自己来写
        ProcessDefinitionQuery query = pe.getRepositoryService().createProcessDefinitionQuery();
        //按照version升序排列
        query.orderByProcessDefinitionVersion().asc(); //排序的方法
        List<ProcessDefinition> list = query.list();   //list展示
        Map<String, ProcessDefinition> map = new HashMap<String, ProcessDefinition>();
        for (ProcessDefinition processDefinition : list) {
            map.put(processDefinition.getKey(), processDefinition);
        }
        System.out.println(map);

        list = new ArrayList<ProcessDefinition>(map.values());
        for (ProcessDefinition processDefinition : list) {
            System.out.println(processDefinition.getName() + "\t" + processDefinition.getId());
        }
    }

    /**
     * 查询一次部署的对应的流程定义文件名称和输入流
     * @throws IOException 
     */
    @Test
    public void test8() throws IOException {
        String deploymentId = "1101"; // 部署ID
        List<String> names = pe.getRepositoryService().getDeploymentResourceNames(deploymentId);
        for (String name : names) {
            System.out.println(name);
            //文件输入流(是用来读取BLOB字段的文件的)
            InputStream inputStream = pe.getRepositoryService().getResourceAsStream(deploymentId, name);
            //读取出数据

            FileUtils.copyInputStreamToFile(inputStream, new File("d:\\" + name));

//          byte[] bytes = new byte[1024];
//          while(inputStream.read(bytes) != -1) {
//              i++;
//              inputStream.read(bytes);
//              outputStream = new FileOutputStream(new File("d:\\" + name));
//              outputStream.write(bytes);
//          }
//          
            inputStream.close();
//          outputStream.close();
        }
    }

    /**
     * 获得图片的输入流
     * @throws IOException 
     */
    @Test
    public void test9() throws IOException {
        //从页面上获取一个流程ID
        String processDefinitionId = "qjlc:9:1404"; // 流程定义ID
        InputStream inputStream = pe.getRepositoryService().getProcessDiagram(processDefinitionId);
        FileUtils.copyInputStreamToFile(inputStream, new File("d:\\my.png"));
        inputStream.close();
    }

6）启动流程实例

    /**
     * 启动流程实例
     * 方式一：根据流程定义的ID启动实例
     * 方式二：根据流程定义的key启动实例 (建议使用,会自动选择最新版本)
     */
    @Test
    public void test10() {
        String processDefinitionId = "qjlc:7:1204"; // 流程定义ID
        //不会管是不是最新的流程版本
        //方式一：根据流程定义的ID启动流程实例
        ProcessInstance pi = pe.getRuntimeService().startProcessInstanceById(processDefinitionId);
        System.out.println(pi.getId());

        String processDefinitionKey = "qjlc";
        //方式二：根据流程定义的key启动流程
        //会根据最新的流程进行启动
        ProcessInstance pi_ = pe.getRuntimeService().startProcessInstanceByKey(processDefinitionKey);
        System.out.println(pi_.getProcessDefinitionId());
    }

7）查询流程实例

    /**
     * 查询流程实例
     */
    @Test
    public void test11() {
        //流程实例查询对象，查询表act_ru_execution
        ProcessInstanceQuery query = pe.getRuntimeService().createProcessInstanceQuery();
        List<ProcessInstance> list = query.list();
        for (ProcessInstance processInstance : list) {
            System.out.println(processInstance.getId()+"\t"+processInstance.getActivityId());
        }
    }

8）删除流程实例

/**
     * 删除流程实例
     */
    @Test
    public void test12() {
        String processInstanceId = "1601"; // 流程实例ID
        String deleteReason = "不请假了";      // 删除流程实例原因
        //删除一个流程实例
        pe.getRuntimeService().deleteProcessInstance(processInstanceId, deleteReason);
    }

9）查询个人任务

    /**
     * 查询个人任务
     */
    @Test
    public void test13() {
        TaskQuery query = pe.getTaskService().createTaskQuery();
        String assignee = "王五";
        query.taskAssignee(assignee);
        List<Task> list = query.list();
        for (Task task : list) {
            System.out.println(task.getId() + "\t" + task.getName());
        }
    }

10）办理个人任务

    /**
     * 办理个人任务
     */
    public void test14() {
        String taskId = "1509"; //注意此处数据必须存在于数据库的taskId表中
        pe.getTaskService().complete(taskId);
    }