当前位置：首页 > news >正文

如何快速构建企业级工作流：Spring Boot + Activiti完整指南 [特殊字符]

news 2026/8/12 12:05:04

如何快速构建企业级工作流：Spring Boot + Activiti完整指南 🚀

【免费下载链接】ActivitiActiviti/Activiti: 是 Activiti 的官方仓库，一个基于 BPMN 2.0 的工作流引擎，支持 Java 和 Spring 框架。适合对工作流引擎、Java 和企业应用开发开发者。项目地址: https://gitcode.com/gh_mirrors/ac/Activiti

在当今企业数字化转型浪潮中，你是否经常面临业务流程混乱、审批效率低下、跨部门协作困难等挑战？工作流引擎正是解决这些痛点的关键技术，而Activiti作为基于BPMN标准的开源工作流引擎，能够帮助你实现流程可视化、自动化执行和智能化管理，让复杂的业务流程变得清晰可控。

5分钟快速集成工作流引擎

环境准备与依赖配置

首先，创建一个新的Spring Boot项目，在pom.xml中添加Activiti依赖：

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

在application.yml中进行基础配置：

spring: activiti: database-schema-update: true check-process-definitions: true async-executor-activate: true

核心配置类实现

创建流程引擎配置类，这是连接Spring Boot与Activiti的关键桥梁：

@Configuration public class ActivitiConfig { @Bean public ProcessEngineConfiguration processEngineConfiguration( DataSource dataSource, PlatformTransactionManager transactionManager) { SpringProcessEngineConfiguration configuration = new SpringProcessEngineConfiguration(); configuration.setDataSource(dataSource); configuration.setTransactionManager(transactionManager); configuration.setDatabaseSchemaUpdate("true"); configuration.setAsyncExecutorActivate(true); return configuration; } }

可视化流程设计的完整步骤

从零开始创建业务流程

让我们以企业中最常见的请假流程为例，展示如何使用Activiti构建完整的业务审批工作流：

@Service public class ProcessDefinitionService { @Autowired private RepositoryService repositoryService; public void deployLeaveProcess() { // 1. 创建BPMN模型构建器 BpmnModel model = Bpmn.createExecutableProcess("leaveProcess") .name("请假审批流程") .startEvent("start") .userTask("applyTask") .name("提交申请") .assignee("${applicant}") .userTask("approveTask") .name("经理审批") .assignee("manager") .exclusiveGateway("decisionGateway") .condition("approved", "${approved}") .endEvent("approveEnd") .moveToLastGateway() .condition("rejected", "${!approved}") .endEvent("rejectEnd") .done(); // 2. 部署流程定义 Deployment deployment = repositoryService.createDeployment() .addBpmnModel("leaveProcess.bpmn", model) .deploy(); System.out.println("请假流程部署成功，ID：" + deployment.getId()); } }

流程可视化效果展示

通过这张流程图，你可以清晰地看到多部门协作的完整审批路径，这正是工作流引擎实现流程可视化的核心价值所在。

企业级工作流的最佳配置方案

数据库连接与事务管理

对于生产环境，建议配置连接池和事务管理：

@Bean @Primary public DataSource dataSource() { HikariDataSource dataSource = new HikariDataSource(); dataSource.setJdbcUrl("jdbc:mysql://localhost:3306/activiti") dataSource.setUsername("root") dataSource.setPassword("password") return dataSource; }

异步执行器优化

为了提升系统性能，配置异步执行器处理后台任务：

@Bean public AsyncExecutor asyncExecutor() { DefaultAsyncExecutor asyncExecutor = new DefaultAsyncExecutor(); asyncExecutor.setDefaultAsyncJobAcquireWaitTime(10000); asyncExecutor.setDefaultTimerJobAcquireWaitTime(10000); return asyncExecutor; }

核心业务流程实现详解

请假审批流程完整实现

让我们构建一个完整的请假审批业务场景：

@RestController @RequestMapping("/workflow") public class WorkflowController { @Autowired private RuntimeService runtimeService; @Autowired private TaskService taskService; /** * 启动请假流程 */ @PostMapping("/leave/start") public String startLeaveProcess(@RequestBody LeaveRequest request) { Map<String, Object> variables = new HashMap<>(); variables.put("applicant", request.getApplicant()); variables.put("leaveDays", request.getLeaveDays()); variables.put("reason", request.getReason()); ProcessInstance processInstance = runtimeService.startProcessInstanceByKey( "leaveProcess", variables); return processInstance.getId(); } /** * 查询待办任务 */ @GetMapping("/tasks/{assignee}") public List<Task> getTasks(@PathVariable String assignee) { return taskService.createTaskQuery() .taskAssignee(assignee) .list(); } }

复杂流程异常处理机制

这张图展示了工作流引擎在复杂业务场景下的强大能力——当并行执行的子流程出现异常时，系统能够通过边界事件捕获错误并执行相应的补偿逻辑。

高级功能与扩展应用

动态流程调整

在实际业务中，流程需求可能随时变化，Activiti支持动态调整：

@Service public class DynamicProcessService { public void modifyRunningProcess(String processInstanceId) { // 动态添加审批节点 runtimeService.addUserIdentityLink(processInstanceId, "additionalApprover", "candidate"); } }

性能监控与优化

集成Spring Boot Actuator实现流程引擎监控：

management: endpoints: web: exposure: include: health,info,metrics

常见问题与解决方案

中文显示问题

问题：流程图中中文显示为乱码

解决方案：

ProcessDiagramGenerator generator = new DefaultProcessDiagramGenerator(); generator.generateDiagram(model, "png", Collections.emptyList(), Collections.emptyList(), "SimHei", "SimHei", null, 1.0, false);

数据库兼容性

Activiti支持多种数据库，包括MySQL、PostgreSQL、Oracle等。配置时只需修改数据源连接即可。

实战案例：完整的审批系统

业务场景描述

假设我们要为一个中型企业构建员工请假审批系统，需求包括：

员工提交请假申请
直属经理审批
超过3天需要部门总监审批
审批结果自动通知相关人员

核心实现代码

@Service public class LeaveProcessService { @Autowired private RuntimeService runtimeService; public void startComplexLeaveProcess(LeaveRequest request) { Map<String, Object> variables = new HashMap<>(); variables.put("applicant", request.getApplicant()); variables.put("leaveDays", request.getLeaveDays()); variables.put("needDirectorApprove", request.getLeaveDays() > 3); ProcessInstance processInstance = runtimeService .startProcessInstanceByKey("complexLeaveProcess", variables); } }