1. 环境搭建与工具配置刚接触Activiti工作流引擎时最头疼的就是环境搭建。记得我第一次配置时光是插件兼容问题就折腾了大半天。现在用IntelliJ IDEA 2024配合Activiti 7整个过程能节省至少50%的时间。下面分享我的实战配置方案1.1 必备插件安装在IntelliJ IDEA的插件市场搜索安装这两个核心插件Activiti BPMN visualizer用于可视化编辑BPMN文件Camunda Modeler更强大的流程图设计工具虽然Activiti自带编辑器但Camunda的功能更完善安装Camunda时有个小技巧不需要从官网下载直接在IDEA的External Tools配置中添加以下参数Program: $ProjectFileDir$/camunda-modeler.exe Arguments: $FilePath$ Working directory: $ProjectFileDir$这样就能在IDEA中右键BPMN文件直接调用Camunda编辑器。1.2 Maven项目初始化创建Maven项目时建议使用这个优化过的pom.xml配置properties activiti.version7.1.0.M6/activiti.version mysql.version8.0.28/mysql.version /properties dependencies !-- Activiti核心包 -- dependency groupIdorg.activiti/groupId artifactIdactiviti-engine/artifactId version${activiti.version}/version /dependency !-- 数据库相关 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version${mysql.version}/version /dependency !-- 日志组件 -- dependency groupIdorg.slf4j/groupId artifactIdslf4j-api/artifactId version1.7.36/version /dependency /dependencies相比旧版本配置这里有三处改进使用MySQL 8.x最新驱动移除了冗余的activiti-cloud依赖采用更新的SLF4J日志门面2. 数据库集成实战2.1 智能化的引擎配置在resources目录下创建activiti.cfg.xml时推荐这种带连接池的配置方案bean iddataSource classcom.zaxxer.hikari.HikariDataSource property namedriverClassName valuecom.mysql.cj.jdbc.Driver/ property namejdbcUrl valuejdbc:mysql://localhost:3306/activiti_db?useSSLfalse/ property nameusername valueroot/ property namepassword valueyourpassword/ property namemaximumPoolSize value10/ /bean bean idprocessEngineConfiguration classorg.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration property namedataSource refdataSource/ property namedatabaseSchemaUpdate valuetrue/ property nameasyncExecutorActivate valuetrue/ /bean关键改进点采用HikariCP连接池替代DBCP启用异步执行器提升性能添加MySQL时区参数避免时区问题2.2 自动建表机制解析执行这段代码会自动创建28张表ProcessEngine engine ProcessEngines.getDefaultProcessEngine();这些表分为五大类运行时表(ACT_RU_)存储运行中的流程实例、任务等历史表(ACT_HI_)记录已完成流程的历史数据身份表(ACT_ID_)存放用户、组信息部署表(ACT_RE_)保存流程定义等静态资源通用表(ACT_GE_)存储引擎全局数据实测发现Activiti 7的表结构相比6.x版本有这些变化新增ACT_RU_DEADLETTER_JOB处理失败作业优化了ACT_HI_VARINST的字段类型移除了部分过时的历史表3. 核心API深度解析3.1 流程部署的两种姿势方式一单文件部署Deployment deployment repositoryService.createDeployment() .name(请假流程) .addClasspathResource(processes/leave.bpmn20.xml) .deploy();适合开发阶段快速迭代。方式二ZIP包部署ZipInputStream zipIn new ZipInputStream( getClass().getResourceAsStream(/processes/leave.zip)); Deployment deployment repositoryService.createDeployment() .addZipInputStream(zipIn) .deploy();生产环境推荐这种方式可以一次性部署BPMN和所有关联资源。3.2 动态任务分配技巧在BPMN文件中使用UEL表达式userTask idleaderApprove name主管审批 activiti:assignee${approverMap[departmentLeader]}/启动流程时传入变量MapString, Object variables new HashMap(); variables.put(approverMap, ImmutableMap.of( departmentLeader, 张经理, hr, 李总监 )); runtimeService.startProcessInstanceByKey(leaveProcess, variables);这种方式的优势审批人变更不需要修改流程定义支持多级审批关系配置审批规则可动态计算4. 高级特性实战4.1 监听器的正确打开方式创建任务监听器类public class AutoAssignListener implements TaskListener { Override public void notify(DelegateTask task) { if(部门审批.equals(task.getName())){ // 根据部门自动分配审批人 String dept (String) task.getVariable(applyDept); task.setAssignee(deptService.findLeaderByDept(dept)); } } }在BPMN中配置userTask iddeptAudit name部门审批 extensionElements activiti:taskListener eventcreate classcom.example.AutoAssignListener/ /extensionElements /userTask4.2 网关使用避坑指南排他网关的典型应用exclusiveGateway iddecision / sequenceFlow idflow1 sourceRefdecision targetRefhrAudit conditionExpression xsi:typetFormalExpression ${days 3} /conditionExpression /sequenceFlow sequenceFlow idflow2 sourceRefdecision targetRefceoAudit conditionExpression xsi:typetFormalExpression ${days 10} /conditionExpression /sequenceFlow常见问题解决方案条件不满足时报错 → 设置默认流向多条件同时满足 → 只会执行第一个为true的分支表达式复杂时 → 建议改用监听器动态计算4.3 历史数据高效查询优化历史查询的三种方式// 1. 分页查询 historyService.createHistoricTaskInstanceQuery() .taskAssignee(张三) .orderByTaskCreateTime().desc() .listPage(0, 10); // 2. 使用索引字段 historyService.createHistoricProcessInstanceQuery() .finishedAfter(startDate) .finishedBefore(endDate) .list(); // 3. 原生SQL查询 managementService.executeCommand(new CustomSqlExecution( HistoricProcessInstance.class, select * from ACT_HI_PROCINST where DURATION_ #{minDuration} ));在大型项目中建议对ACT_HI_*表做定期归档。我曾处理过一个流程实例超过百万的系统通过按月分表使查询性能提升了8倍。
IntelliJ IDEA 2024 + Activiti 7：从零构建企业级工作流应用（环境搭建与核心API实战）
1. 环境搭建与工具配置刚接触Activiti工作流引擎时最头疼的就是环境搭建。记得我第一次配置时光是插件兼容问题就折腾了大半天。现在用IntelliJ IDEA 2024配合Activiti 7整个过程能节省至少50%的时间。下面分享我的实战配置方案1.1 必备插件安装在IntelliJ IDEA的插件市场搜索安装这两个核心插件Activiti BPMN visualizer用于可视化编辑BPMN文件Camunda Modeler更强大的流程图设计工具虽然Activiti自带编辑器但Camunda的功能更完善安装Camunda时有个小技巧不需要从官网下载直接在IDEA的External Tools配置中添加以下参数Program: $ProjectFileDir$/camunda-modeler.exe Arguments: $FilePath$ Working directory: $ProjectFileDir$这样就能在IDEA中右键BPMN文件直接调用Camunda编辑器。1.2 Maven项目初始化创建Maven项目时建议使用这个优化过的pom.xml配置properties activiti.version7.1.0.M6/activiti.version mysql.version8.0.28/mysql.version /properties dependencies !-- Activiti核心包 -- dependency groupIdorg.activiti/groupId artifactIdactiviti-engine/artifactId version${activiti.version}/version /dependency !-- 数据库相关 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version${mysql.version}/version /dependency !-- 日志组件 -- dependency groupIdorg.slf4j/groupId artifactIdslf4j-api/artifactId version1.7.36/version /dependency /dependencies相比旧版本配置这里有三处改进使用MySQL 8.x最新驱动移除了冗余的activiti-cloud依赖采用更新的SLF4J日志门面2. 数据库集成实战2.1 智能化的引擎配置在resources目录下创建activiti.cfg.xml时推荐这种带连接池的配置方案bean iddataSource classcom.zaxxer.hikari.HikariDataSource property namedriverClassName valuecom.mysql.cj.jdbc.Driver/ property namejdbcUrl valuejdbc:mysql://localhost:3306/activiti_db?useSSLfalse/ property nameusername valueroot/ property namepassword valueyourpassword/ property namemaximumPoolSize value10/ /bean bean idprocessEngineConfiguration classorg.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration property namedataSource refdataSource/ property namedatabaseSchemaUpdate valuetrue/ property nameasyncExecutorActivate valuetrue/ /bean关键改进点采用HikariCP连接池替代DBCP启用异步执行器提升性能添加MySQL时区参数避免时区问题2.2 自动建表机制解析执行这段代码会自动创建28张表ProcessEngine engine ProcessEngines.getDefaultProcessEngine();这些表分为五大类运行时表(ACT_RU_)存储运行中的流程实例、任务等历史表(ACT_HI_)记录已完成流程的历史数据身份表(ACT_ID_)存放用户、组信息部署表(ACT_RE_)保存流程定义等静态资源通用表(ACT_GE_)存储引擎全局数据实测发现Activiti 7的表结构相比6.x版本有这些变化新增ACT_RU_DEADLETTER_JOB处理失败作业优化了ACT_HI_VARINST的字段类型移除了部分过时的历史表3. 核心API深度解析3.1 流程部署的两种姿势方式一单文件部署Deployment deployment repositoryService.createDeployment() .name(请假流程) .addClasspathResource(processes/leave.bpmn20.xml) .deploy();适合开发阶段快速迭代。方式二ZIP包部署ZipInputStream zipIn new ZipInputStream( getClass().getResourceAsStream(/processes/leave.zip)); Deployment deployment repositoryService.createDeployment() .addZipInputStream(zipIn) .deploy();生产环境推荐这种方式可以一次性部署BPMN和所有关联资源。3.2 动态任务分配技巧在BPMN文件中使用UEL表达式userTask idleaderApprove name主管审批 activiti:assignee${approverMap[departmentLeader]}/启动流程时传入变量MapString, Object variables new HashMap(); variables.put(approverMap, ImmutableMap.of( departmentLeader, 张经理, hr, 李总监 )); runtimeService.startProcessInstanceByKey(leaveProcess, variables);这种方式的优势审批人变更不需要修改流程定义支持多级审批关系配置审批规则可动态计算4. 高级特性实战4.1 监听器的正确打开方式创建任务监听器类public class AutoAssignListener implements TaskListener { Override public void notify(DelegateTask task) { if(部门审批.equals(task.getName())){ // 根据部门自动分配审批人 String dept (String) task.getVariable(applyDept); task.setAssignee(deptService.findLeaderByDept(dept)); } } }在BPMN中配置userTask iddeptAudit name部门审批 extensionElements activiti:taskListener eventcreate classcom.example.AutoAssignListener/ /extensionElements /userTask4.2 网关使用避坑指南排他网关的典型应用exclusiveGateway iddecision / sequenceFlow idflow1 sourceRefdecision targetRefhrAudit conditionExpression xsi:typetFormalExpression ${days 3} /conditionExpression /sequenceFlow sequenceFlow idflow2 sourceRefdecision targetRefceoAudit conditionExpression xsi:typetFormalExpression ${days 10} /conditionExpression /sequenceFlow常见问题解决方案条件不满足时报错 → 设置默认流向多条件同时满足 → 只会执行第一个为true的分支表达式复杂时 → 建议改用监听器动态计算4.3 历史数据高效查询优化历史查询的三种方式// 1. 分页查询 historyService.createHistoricTaskInstanceQuery() .taskAssignee(张三) .orderByTaskCreateTime().desc() .listPage(0, 10); // 2. 使用索引字段 historyService.createHistoricProcessInstanceQuery() .finishedAfter(startDate) .finishedBefore(endDate) .list(); // 3. 原生SQL查询 managementService.executeCommand(new CustomSqlExecution( HistoricProcessInstance.class, select * from ACT_HI_PROCINST where DURATION_ #{minDuration} ));在大型项目中建议对ACT_HI_*表做定期归档。我曾处理过一个流程实例超过百万的系统通过按月分表使查询性能提升了8倍。
