# SpringBoot 整合 Activiti 工作流框架

Posted 2022-02-23 MarlonBrando1998

SpringBoot 整合 Activiti 工作流框架

Activiti 介绍

• Activiti是一个开源的工作流引擎，它实现了BPMN 2.0规范，可以发布设计好的流程定义，并通过api进行流程调度。Activiti 作为一个遵从 Apache 许可的工作流和业务流程管理开源平台，其核心是基于 Java 的超快速、超稳定的 BPMN2.0 流程引擎，强调流程服务的可嵌入性和可扩展性，同时更加强调面向业务人员。

• 简单来说activiti是一个业务流程管理引擎，会沿着设计者设计好的流程，一步一步的执行下去，直到终点。

SpringBoot 整合

配置

• activiti会框架会创建一系列的表，所以要配置相关数据库的信息，需要注意的是，在url中，添加了针对数据库的条件，其中最后一条nullCatalogMeansCurrent=true非常重要，至于有什么用就不概述了，但是没有这条语句的话就无法自动创建对应的二十八张表。

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
    # 监控统计拦截的filters，如果启用log4j记得添加依赖
    filters: stat,wall
  # activiti
  activiti:
    #每次应用启动不检查Activiti数据表是否存在及版本号是否匹配，提升应用启动速度
    database-schema-update: true
    #在项目单独作为一个引擎，本身不部署流程的时候，如果resources目录没有“processes”目录，启动项目报错–找不到processes目录。需要在配置文件中添加以下内容：
    check-process-definitions: false
    process-definition-location-prefix: classpath:/processes/
    process-definition-location-suffixes:
      -**.bpmn
      -**.bpmn20.xml
    #保存历史数据级别设置为full最高级别，便于历史数据的追溯
    history-level: full
  # activiti 安全访问
  security:
    basic:
      enabled: true
    user:
      name: root
      password: root

版本问题

• 注意 SpringBoot 和 Activiti 的版本问题
• springboot2.0不能与activiti6.0.0直接集成使用，因为activiti6.0.0出来的时候springboot2.0还没有出来，activiti6.0.0 支持springboot1.2.6以上，2.0.0以下的版本。

---

使用 starter

依赖

• 这个版本满足高版本的springboot，直接使用就行

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

• 需要注意的是，这里的依赖版本，需要对应数据库中act_ge_property表中schema.version版本信息，所以一般不建议在创建完表之后修改依赖信息

• 启动项目成功后自动创建表

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

 # activiti 安全访问
  security:
    basic:
      enabled: true
    user:
      name: root
      password: root

不使用 starter

依赖

<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. 创建ActivitiConfig
     * 2. 使用ActivitiConfig创建ProcessEngineFactoryBean
     * 3. 使用ProcessEngineFactoryBean创建ProcessEngine对象
     * 4. 使用ProcessEngine对象创建需要的服务对象
     */
    private final DataSource dataSource;

    private final PlatformTransactionManager platformTransactionManager;

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

    /*
     * 1. 创建配置文件，也就是提供一些配置信息，这样就可以自定义自己的创建信息了
     * 需要一些参数，1. 数据源。2. 事务管理器。
     * 这里还加入了自动扫描process包下的bpmn(流程定义文件)的设置，这样就可以省去了部署
     * */
    @Bean
    public SpringProcessEngineConfiguration springProcessEngineConfiguration() 
        SpringProcessEngineConfiguration spec = new SpringProcessEngineConfiguration();
        spec.setDataSource(dataSource);
        spec.setTransactionManager(platformTransactionManager);
        spec.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);
        Resource[] resources = null;
        // 启动自动部署流程
        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中创建process文件夹，文件夹的路径和名字需要和ActivitiConfig中的配置保持一致
• 启动springBoot项目即可创建完成

---

使用 Activiti

• Idea 安装 Activiti BPMN visualizer 插件

编写测试 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>

编写测试代码

• 测试代码

@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("流程启动成功，流程id:", pi.getId());
    


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

…简单配置到此结束

完整配置代码见 ：https://gitee.com/Marlon_Brando/onlineshop_back/tree/develop/os_workflow