SpringBoot整合Activiti工作流框架的使用

更新時(shí)間：2022年02月18日 10:45:46 作者：MarlonBrando1998

本文主要介紹了SpringBoot整合Activiti工作流框架的使用，文中通過(guò)示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下

Activiti 介紹

Activiti是一個(gè)開(kāi)源的工作流引擎，它實(shí)現(xiàn)了BPMN 2.0規(guī)范，可以發(fā)布設(shè)計(jì)好的流程定義，并通過(guò)api進(jìn)行流程調(diào)度。Activiti 作為一個(gè)遵從 Apache 許可的工作流和業(yè)務(wù)流程管理開(kāi)源平臺(tái)，其核心是基于 Java 的超快速、超穩(wěn)定的 BPMN2.0 流程引擎，強(qiáng)調(diào)流程服務(wù)的可嵌入性和可擴(kuò)展性，同時(shí)更加強(qiáng)調(diào)面向業(yè)務(wù)人員。
簡(jiǎn)單來(lái)說(shuō)activiti是一個(gè)業(yè)務(wù)流程管理引擎，會(huì)沿著設(shè)計(jì)者設(shè)計(jì)好的流程，一步一步的執(zhí)行下去，直到終點(diǎn)。

SpringBoot 整合

配置

activiti會(huì)框架會(huì)創(chuàng)建一系列的表，所以要配置相關(guān)數(shù)據(jù)庫(kù)的信息，需要注意的是，在url中，添加了針對(duì)數(shù)據(jù)庫(kù)的條件，其中最后一條nullCatalogMeansCurrent=true非常重要，至于有什么用就不概述了，但是沒(méi)有這條語(yǔ)句的話(huà)就無(wú)法自動(dòng)創(chuàng)建對(duì)應(yīng)的二十八張表。

server:
  port: 8014

spring:
  application:
    name: workflow
  datasource:
    name: mysqlDatasource
    url: jdbc:mysql://localhost:3306/core?useUnicode=true&nullCatalogMeansCurrent=true
    username: root
    password: root
    driver-class-name: com.mysql.jdbc.Driver
    type: com.alibaba.druid.pool.DruidDataSource
    # 監(jiān)控統(tǒng)計(jì)攔截的filters，如果啟用log4j記得添加依賴(lài)
    filters: stat,wall
  # activiti
  activiti:
    #每次應(yīng)用啟動(dòng)不檢查Activiti數(shù)據(jù)表是否存在及版本號(hào)是否匹配，提升應(yīng)用啟動(dòng)速度
    database-schema-update: true
    #在項(xiàng)目單獨(dú)作為一個(gè)引擎，本身不部署流程的時(shí)候，如果resources目錄沒(méi)有“processes”目錄，啟動(dòng)項(xiàng)目報(bào)錯(cuò)–找不到processes目錄。需要在配置文件中添加以下內(nèi)容：
    check-process-definitions: false
    process-definition-location-prefix: classpath:/processes/
    process-definition-location-suffixes:
      -**.bpmn
      -**.bpmn20.xml
    #保存歷史數(shù)據(jù)級(jí)別設(shè)置為full最高級(jí)別，便于歷史數(shù)據(jù)的追溯
    history-level: full
  # activiti 安全訪(fǎng)問(wèn)
  security:
    basic:
      enabled: true
    user:
      name: root
      password: root

版本問(wèn)題

注意 SpringBoot 和 Activiti 的版本問(wèn)題
springboot2.0不能與activiti6.0.0直接集成使用，因?yàn)?code>activiti6.0.0出來(lái)的時(shí)候springboot2.0還沒(méi)有出來(lái)，activiti6.0.0 支持springboot1.2.6以上，2.0.0以下的版本。

使用 starter

依賴(lài)

這個(gè)版本滿(mǎn)足高版本的springboot，直接使用就行

<dependency>
    <groupId>org.activiti</groupId>
    <artifactId>activiti-spring-boot-starter</artifactId>
    <version>7.1.0.M3.1</version>
</dependency>

需要注意的是，這里的依賴(lài)版本，需要對(duì)應(yīng)數(shù)據(jù)庫(kù)中act_ge_property表中schema.version版本信息，所以一般不建議在創(chuàng)建完表之后修改依賴(lài)信息

啟動(dòng)項(xiàng)目成功后自動(dòng)創(chuàng)建表

請(qǐng)?zhí)砑訄D片描述

需要在配置文件中加上 activiti-security的配置

 # activiti 安全訪(fǎng)問(wèn)
  security:
    basic:
      enabled: true
    user:
      name: root
      password: root

不使用 starter

依賴(lài)

<dependency>
    <groupId>org.activiti</groupId>
    <artifactId>activiti-spring</artifactId>
    <version>6.0.0</version>
</dependency>

配置代碼

@Configuration
public class ActivitiConfig {

    private static final Logger logger = LoggerFactory.getLogger(ActivitiConfig.class);


    /**
     * 配置分為以下幾步驟
     * 1. 創(chuàng)建ActivitiConfig
     * 2. 使用ActivitiConfig創(chuàng)建ProcessEngineFactoryBean
     * 3. 使用ProcessEngineFactoryBean創(chuàng)建ProcessEngine對(duì)象
     * 4. 使用ProcessEngine對(duì)象創(chuàng)建需要的服務(wù)對(duì)象
     */
    private final DataSource dataSource;

    private final PlatformTransactionManager platformTransactionManager;

    @Autowired
    public ActivitiConfig(DataSource dataSource, PlatformTransactionManager transactionManager) {
        this.dataSource = dataSource;
        platformTransactionManager = transactionManager;
    }

    /*
     * 1. 創(chuàng)建配置文件，也就是提供一些配置信息，這樣就可以自定義自己的創(chuàng)建信息了
     * 需要一些參數(shù)，1. 數(shù)據(jù)源。2. 事務(wù)管理器。
     * 這里還加入了自動(dòng)掃描process包下的bpmn(流程定義文件)的設(shè)置，這樣就可以省去了部署
     * */
    @Bean
    public SpringProcessEngineConfiguration springProcessEngineConfiguration() {
        SpringProcessEngineConfiguration spec = new SpringProcessEngineConfiguration();
        spec.setDataSource(dataSource);
        spec.setTransactionManager(platformTransactionManager);
        spec.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);
        Resource[] resources = null;
        // 啟動(dòng)自動(dòng)部署流程
        try {
            resources = new PathMatchingResourcePatternResolver().getResources("classpath*:processes/*.*.xml");
        } catch (IOException e) {
            logger.error("Error Occur:", e);
        }
        spec.setDeploymentResources(resources);
        return spec;
    }

    @Bean
    public ProcessEngineFactoryBean processEngine() {
        ProcessEngineFactoryBean engineFactoryBean = new ProcessEngineFactoryBean();
        engineFactoryBean.setProcessEngineConfiguration(springProcessEngineConfiguration());
        return engineFactoryBean;
    }

    @Bean
    public RepositoryService repositoryService() throws Exception {
        return Objects.requireNonNull(processEngine().getObject()).getRepositoryService();
    }

    @Bean
    public RuntimeService runtimeService() throws Exception {
        return Objects.requireNonNull(processEngine().getObject()).getRuntimeService();
    }

    @Bean
    public TaskService taskService() throws Exception {
        return Objects.requireNonNull(processEngine().getObject()).getTaskService();
    }

    @Bean
    public HistoryService historyService() throws Exception {
        return Objects.requireNonNull(processEngine().getObject()).getHistoryService();
    }
}

在resources中創(chuàng)建process文件夾，文件夾的路徑和名字需要和ActivitiConfig中的配置保持一致啟動(dòng)springBoot項(xiàng)目即可創(chuàng)建完成

使用 Activiti

Idea 安裝 Activiti BPMN visualizer 插件

編寫(xiě)測(cè)試 bpmn.xml

<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:activiti="http://activiti.org/bpmn"
             xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI"
             xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC" xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI"
             typeLanguage="http://www.w3.org/2001/XMLSchema" expressionLanguage="http://www.w3.org/1999/XPath"
             targetNamespace="http://www.activiti.org/processdef">
    <process id="test" name="test" isExecutable="true">
        <startEvent id="startevent1" name="Start"></startEvent>
        <endEvent id="endevent1" name="End"></endEvent>
        <userTask id="usertask1" name="HelloWorld" activiti:assignee="goxcheer"></userTask>
        <sequenceFlow id="flow1" sourceRef="startevent1" targetRef="usertask1"></sequenceFlow>
        <sequenceFlow id="flow2" sourceRef="usertask1" targetRef="endevent1"></sequenceFlow>
    </process>
    <bpmndi:BPMNDiagram id="BPMNDiagram_test">
        <bpmndi:BPMNPlane bpmnElement="test" id="BPMNPlane_test">
            <bpmndi:BPMNShape bpmnElement="startevent1" id="BPMNShape_startevent1">
                <omgdc:Bounds height="35.0" width="41.0" x="220.0" y="180.0"></omgdc:Bounds>
            </bpmndi:BPMNShape>
            <bpmndi:BPMNShape bpmnElement="endevent1" id="BPMNShape_endevent1">
                <omgdc:Bounds height="35.0" width="35.0" x="640.0" y="180.0"></omgdc:Bounds>
            </bpmndi:BPMNShape>
            <bpmndi:BPMNShape bpmnElement="usertask1" id="BPMNShape_usertask1">
                <omgdc:Bounds height="55.0" width="105.0" x="390.0" y="170.0"></omgdc:Bounds>
            </bpmndi:BPMNShape>
            <bpmndi:BPMNEdge bpmnElement="flow1" id="BPMNEdge_flow1">
                <omgdi:waypoint x="261.0" y="197.0"></omgdi:waypoint>
                <omgdi:waypoint x="390.0" y="197.0"></omgdi:waypoint>
            </bpmndi:BPMNEdge>
            <bpmndi:BPMNEdge bpmnElement="flow2" id="BPMNEdge_flow2">
                <omgdi:waypoint x="495.0" y="197.0"></omgdi:waypoint>
                <omgdi:waypoint x="640.0" y="197.0"></omgdi:waypoint>
            </bpmndi:BPMNEdge>
        </bpmndi:BPMNPlane>
    </bpmndi:BPMNDiagram>
</definitions>

編寫(xiě)測(cè)試代碼

測(cè)試代碼

@RequestMapping("/test")
@RestController
public class ActivitiTestController {

    private static final Logger logger = LoggerFactory.getLogger(ActivitiTestController.class);

    @Autowired
    RuntimeService runtimeService;

    @Autowired
    private TaskService taskService;

    @RequestMapping("/test1")
    public void test1() {
        logger.info("Start.........");
        ProcessInstance pi = runtimeService.startProcessInstanceByKey("test");
        logger.info("流程啟動(dòng)成功，流程id:{}", pi.getId());
    }


    @RequestMapping("/test2")
    public void test2() {
        String userId = "root";
        List<Task> resultTask = taskService.createTaskQuery().processDefinitionKey("test").taskCandidateOrAssigned(userId).list();
        logger.info("任務(wù)列表：{}", resultTask);
    }

}

…簡(jiǎn)單配置到此結(jié)束