Activiti基本操作整理

一、Activiti介绍

Activiti项目是一项新的基于Apache许可的开源BPM平台,从基础开始构建,旨在提供支持新的BPMN 2.0标准,包括支持对象管理组(OMG),面对新技术的机遇,诸如互操作性和云架构,提供技术实现。
Activiti是一个独立运作和经营的开源项目品牌,并将独立于Alfresco开源ECM(企业内容管理)系统运行。Activiti将是一种轻量级,可嵌入的BPM引擎,而且还设计适用于可扩展的云架构。

官网给出的定义如下Activiti 是一个针对企业用户、开发人员 、系统管理员的轻量级工作流业务管理平台(Business Process Management, 简称BPM),其核心是使用 Java 开发的快速 、 稳定的 BPMN2.0 流程引擎 。Activiti是开源的,并基于Apache许可发行。Activiti可以在任何Java应用程序、服务器、集群或云中运行,它可以与 Spring 完美集成。
Activiti Github地址https://github.com/Activiti/Activiti

二、Activiti插件

Activiti要在Eclipse中使用,需要安装如下插件
在这里插入图片描述
在这里插入图片描述

三、配置启动流程

1.引入配置文件

Activiti自带的表在实际开发中是使用activiti.cfg.xml配置文件生成,在src/test/resources下创建一个xml文件 名字是:activiti.cfg.xml

<?xml version="1.0" encoding="UTF-8"?>
<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://localhost:3306/db_activiti" />
    <property name="jdbcDriver" value="com.mysql.jdbc.Driver" />
    <property name="jdbcUsername" value="root" />
    <property name="jdbcPassword" value="123456" />
    <property name="databaseSchemaUpdate" value="true" />
  </bean>
</beans>

2.获取流程引擎实例

/**
* 使用xml配置 简化
*/
@Test
public void testCreateTableWithXml(){
    // 引擎配置
    ProcessEngineConfiguration pec=ProcessEngineConfiguration.createProcessEngineConfigurationFromResource("activiti.cfg.xml");
    // 获取流程引擎对象
    ProcessEngine processEngine=pec.buildProcessEngine();
}

流程引擎配置对象的继承树如下:
在这里插入图片描述
流程引擎对象默认使用h2内存数据库
在这里插入图片描述
在创建完上面的流程引擎对象后,生成28张数据表
在这里插入图片描述
activiti5.19.0.2支持的是25张表
在这里插入图片描述

3.使用Eclipse绘制流程图

在这里插入图片描述
启动流程实例步骤分三步:
1.部署流程定义文件(涉及到资源表,流程部署记录表,流程定义信息表)
2.启动流程实例
3.查看流程任务以及完成流程任务

4.部署流程定义文件

public void deploy() {
	Deployment deployment = processEngine.getRepositoryService()
						.createDeployment()
						.addClasspathResource("diagrams/MyProcess.bpmn")
						.addClasspathResource("diagrams/MyProcess.png")
						.name("FirstApprove流程")
						.deploy();
	System.out.println("流程部署ID:"+deployment.getId());
	System.out.println("流程部署Name:"+deployment.getName());
}

部署完之后,三张表的变化
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

5.启动流程实例

//启动流程实例
@Test
public void start() {
    ProcessInstance processInstance =  processEngine.getRuntimeService().startProcessInstanceByKey(“myProcess”);//通过流程定义表中的key_字段获取
    System.out.println("流程实例ID:"+processInstance.getId());
    System.out.println("流程定义ID:"+processInstance.getProcessDefinitionId());
}

表的变化:
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

6.执行任务

@Test
public void completeTask(){
	processEngine.getTaskService() // 任务相关Service
             .complete("2505"); // 指定要完成的任务ID
}

表的变化
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在历史表中,包括历史参与者表、历史任务表、历史节点信息表,未完成的任务所涉及的参与者、节点信息都会记录
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

7.查看任务

//查看任务
@Test
public void findTask(){
    // 查询并且返回任务即可
    List<Task> taskList=processEngine.getTaskService() // 任务相关Service
            .createTaskQuery()  // 创建任务查询
            .taskAssignee("李四") // 指定某个人
            .list();
    for(Task task:taskList){
        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());
    }
}

在这里插入图片描述
当完成最后一个人工任务后,所有的以act_run_开头的表都置空,但能在历史信息表中查看到相关信息
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

四、Activiti的实际应用

Activiti流程定义ZIP部署方式

Activiti支持以压缩包的形式部署流程定义文件,从而摆脱通过classpath方式加载资源文件的局限性。

/**
* 使用zip方式部署流程定义文件
*/
@Test
public void deployWithZip() {
	InputStream imInputStream = this.getClass().getClassLoader()
		.getResourceAsStream("diagrams/MyProcessZipTest.zip");//获取指定文件资源流
	ZipInputStream zipInputStream = new ZipInputStream(imInputStream);//实例化zip输入流
	Deployment deployment = processEngine.getRepositoryService()
		.createDeployment()
		.name("MyProcessZip部署")
		.addZipInputStream(zipInputStream)
		.deploy();
	System.out.println("流程部署ID:"+deployment.getId());
	System.out.println("流程部署Name:"+deployment.getName());
}

因为MyProcessZipTest.zip压缩包中含有两个文件,bpmn和png,因此上传到流程引擎中之后,在act_ge_bytearray中多了两个资源文件,相应的数据表的变化:
在这里插入图片描述
在这里插入图片描述

Activiti流程定义查询

  • 通过Activiti提供的API 把act_re_procdef表的所有列的数据全部查询出来,在开发系统的时候管理员、用户可以通过用户界面来维护这些数据。
  • Activiti提供非常丰富的API,可以做SQL查询、对某些字段查询、模糊查询、分页查询和排序等。
/**
* 查询流程定义,返回流程定义集合
*/
@Test
public void ListAll() {
	List<ProcessDefinition> list = processEngine.getRepositoryService()
		.createProcessDefinitionQuery()//创建流程定义查询
		.processDefinitionKey("myProcess")
		.list();
	for(ProcessDefinition pdf : list) {
	System.out.println("ID=" + pdf.getId());
	System.out.println("Name=" + pdf.getName());
	System.out.println("Key=" + pdf.getKey());
	System.out.println("Version" + pdf.getVersion());
	System.out.println("=================");
	}
}

在这里插入图片描述
activiti提供的流程定义查询方法:
在这里插入图片描述

Activiti流程定义删除

  • 在开发中肯定会有一些流程不需要了,要删除,Activiti中也是存在删除操作的
  • 通过流程定义部署ID来执行删除流程定义
/**
* 删除流程定义文件,通过流程定义部署ID来进行删除
*/
@Test
public void deleteProdef() {
	processEngine.getRepositoryService().deleteDeployment("15001");
	System.out.println("删除流程定义" );
}
/**
* 级联删除,正在运行的流程实例也会删除,包括历史记录表中的信息也会被删除
*/
@Test
public void deleteProdefForce() {
	processEngine.getRepositoryService().deleteDeployment("15001", true);//默认是False,true表示级联删除
	System.out.println("删除流程定义成功" );
}

不能删除正在运行的流程定义文件,有主外键关系
Cannot delete or update a parent row: a foreign key constraint fails (db_activiti.act_ru_execution, CONSTRAINT ACT_FK_EXE_PROCDEF FOREIGN KEY (PROC_DEF_ID_) REFERENCES act_re_procdef (ID_))

Activiti查看流程图片

  • 在开发中可能需要查看某个流程的流程图片,对应操作的数据库表是act_ge_bytearray的Bytes_字段
  • Activiti提供了操作接口,可以查询返回一个资源文件输入流,然后就可以得到这张流程图片保存到本地服务器,然后图片多在自己的服务器上

需要commons-io依赖

<dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.4</version>
</dependency>
ProcessEngine processEngine  =  ProcessEngines.getDefaultProcessEngine();
/**
* 通过流程部署ID获得流程图片
* @throws IOException
*/
@Test
public void getImageById() throws IOException {
	InputStream inputStream = processEngine.getRepositoryService().getResourceAsStream("1", "diagrams/MyProcess.png");
	FileUtils.copyInputStreamToFile(inputStream, new File("D:/MyProcess.png"));
}

在这里插入图片描述

Activiti修改流程定义

流程定义按本质来说是不能修改的。所以在开发中,不能修改流程定义,而是通过增加版本号的方式。来实现“修改”的。
在这里插入图片描述
每进行一次流程部署,version就会加1,启动流程实例的时候,是用Key来启动。这样启动的时候就是用的最新版本的流程定义来启动流程实例。Id值组成是 key值:版本号:流程定义ID
在这里插入图片描述

Activiti删除key相同的流程

一个流程定义不需要的,需要删除所有版本
把所有Key相同的流程定义批量删除
1、根据Key查询所有的流程定义
2、遍历集合,取得每个流程的部署ID
3、根据流程部署ID即可删除所有的流程定义

public void deleteProdefBykeyForce() {
	List<ProcessDefinition> list = processEngine.getRepositoryService().createProcessDefinitionQuery().processDefinitionKey("myProcess").list();
	for(ProcessDefinition pd : list) {
    System.out.println(pd.getDeploymentId());
    //processEngine.getRepositoryService().deleteDeployment(pd.getDeploymentId(), true);
    }
}

Activiti历史流程操作

act_hi_procinst表的id和流程实例id始终是一样的

/**
* 历史流程实例相关信息查询
* 根据流程实例ID进行查询
*/
@Test
public void getHistoryProcessInstance() {
    HistoricProcessInstance historicProcessInstance = processEngine.getHistoryService().createHistoricProcessInstanceQuery().processInstanceId("2501").singleResult();
    System.out.println("=======历史流程实例相关信息查询===========");
    System.out.println("流程实例ID:"+ historicProcessInstance.getId());
    System.out.println("流程实例创建时间:"+ historicProcessInstance.getStartTime());
    System.out.println("流程实例结束时间:"+ historicProcessInstance.getEndTime());
}
/**
* 历史任务实例相关信息查询
* 查询某个流程定义的所有历史任务
*/
@Test
public void getHistoryTaskQuery() {
    List<HistoricTaskInstance> list = processEngine.getHistoryService().createHistoricTaskInstanceQuery().processDefinitionId("myProcess:1:4").finished().list();
    System.out.println("=======历史任务实例相关信息查询===========");
    for(HistoricTaskInstance his : list) {
        System.out.println("任务ID:" + his.getId());
        System.out.println("流程实例ID:" + his.getProcessInstanceId());
        System.out.println("办理人:" + his.getAssignee());
        System.out.println("================");
    }
}

Activiti流程变量设置与获取

根据流程定义的key启动一个流程

@Test
public void start() {
    ProcessInstance processInstance = processEngine.getRuntimeService().startProcessInstanceByKey("employeeMyProcess");
    System.out.println("流程实例ID:" + processInstance.getId());
    System.out.println("流程实例创建时间:" + processInstance.getStartTime());
}

设置流程变量
要设置流程变量,需要获取Service,在这里,TaskService可以设置变量,RuntimeService也可以设置流程变量
假如节点不是任务节点的时候,只能用RuntimeService。接口和方法和TaskService一样的;执行设置变量的方法会对应的把数据库查询到对应的流程变量表(act_ru_variable)中,当然那个序列化对象,特殊点,存到了字节文件表(act_ge_bytearray)里去了

@Test
public void setProcVariable() {
    String taskId = "27505";
    Employee employee = new Employee(1526, "张三");
    TaskService taskService = processEngine.getTaskService();
    taskService.setVariable(taskId, "date", new Date());
    taskService.setVariable(taskId, "reason", "发烧");
    taskService.setVariable(taskId, "days", 2);
    taskService.setVariable(taskId, "employee", employee);//序列化对象
}

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
获取“员工请假提交”任务节点设置的流程变量

@Test
public void getVariables() {
    TaskService taskService = processEngine.getTaskService();
    String taskId = "32502";
    Employee employee = (Employee) taskService.getVariable(taskId, "employee");
    Date date = (Date) taskService.getVariable(taskId, "date");
    String reason = (String) taskService.getVariable(taskId, "reason");
    Integer days = (Integer) taskService.getVariable(taskId, "days");
    System.out.println("请假人:" + employee);
    System.out.println("请假日期:" + date);
    System.out.println("请假原因" + reason);
    System.out.println("请假天数:" + days);
}

在这里插入图片描述

Activiti连线

在这里插入图片描述
完成任务

public class EmplyeeTest2 {
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
//部署流程
@Test
public void deploy() {
    Deployment deployment = processEngine.getRepositoryService()
        .createDeployment()
        .addClasspathResource("diagrams/employeeMyProcess2.bpmn")
        .addClasspathResource("diagrams/employeeMyProcess2.png")
        .name("员工请假流程2")
        .deploy();
    System.out.println("流程部署ID:"+deployment.getId());
    System.out.println("流程部署Name:"+deployment.getName());
}
//启动一个流程实例
@Test
public void start() {
    ProcessInstance processInstance = processEngine.getRuntimeService().startProcessInstanceByKey("employeeMyProcess2");
    System.out.println("流程实例ID:" + processInstance.getId());
    System.out.println("流程定义ID:" + processInstance.getProcessDefinitionId());
    System.out.println("流程实例创建时间:" + processInstance.getStartTime());
}
//查看任务
@Test
public void findTask(){
    // 查询并且返回任务即可
    List<Task> taskList=processEngine.getTaskService() // 任务相关Service
            .createTaskQuery()  // 创建任务查询
            .taskAssignee("李四") // 指定某个人
            .list();
    for(Task task:taskList){
        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());
    }
}
//完成任务
@Test
public void completeTask() {
    processEngine.getTaskService().complete("42503");
}
@Test
public void completeTask2() {
    Map<String, Object> variables = new HashMap<String, Object>();
    variables.put("msg", "重要情况");
    processEngine.getTaskService().complete("40002", variables);
    }
}

Activiti排他网关

private static String completeTask(String taskID){
    String daysValue = "7";
    Map<String, Object> variables = new HashMap<>();
    variables.put("days",daysValue);
    processEngine.getTaskService().complete(taskID, variables);
    System.out.println("完成任务:" + taskID);
    System.out.println("下一任务:" + processEngine.getTaskService()
            .createTaskQuery().singleResult().getName());
    return processEngine.getTaskService().createTaskQuery().singleResult().getId();
}


private static void completeTask2(String taskID){
    System.out.println("当前任务:" + processEngine.getTaskService()
            .createTaskQuery().singleResult().getName());
    processEngine.getTaskService().complete(taskID);
    System.out.println("完成任务");
}

在这里插入图片描述

Activiti并行网关

private static void completeTask(String taskID){
    processEngine.getTaskService().complete(taskID);
    System.out.println("完成任务:" + taskID);
    List<Task> taskList = processEngine.getTaskService().createTaskQuery().list();
    for(Task task : taskList){
        System.out.println("任务名称:" + task.getName());
        System.out.println("任务委任人:" + task.getAssignee());
        System.out.println("=================");
    }
}


private static void completeTask2(){
    List<Task> taskList = processEngine.getTaskService().createTaskQuery()
            .processInstanceId("90005").list();
    if (taskList.size()>0){
        for(Task task : taskList){
            System.out.println("任务名称:" + task.getName());
            System.out.println("任务委任人:" + task.getAssignee());
            processEngine.getTaskService().complete(task.getId());
            System.out.println("完成任务:" + task.getName());
        }
    }
}

在这里插入图片描述

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章