第二章activiti“开发环境搭建训练营”

一、“工具箱”准备——开发环境四件套 1. 基础装备清单 工具名称版本要求作用JDK1.8+运行Java程序Maven3.6+依赖管理与项目构建IDEEclipse/IDEA代码编写与调试数据库H2/MySQL 5.7+存储流程数据（H2适合快速入门）

验证安装：

java -version # 输出：java version "1.8.0_301" mvn -v # 输出：Apache Maven 3.8.4

---

二、创建“引擎车间”——Maven项目搭建 1. 生成项目骨架 mvn archetype:generate -DgroupId=com.activiti.lab -DartifactId=activiti-lab -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false 2. 添加“动力燃料”——Maven依赖

在pom.xml中注入Activiti核心依赖：

<dependency> <groupId>org.activiti</groupId> <artifactId>activiti-engine</artifactId> <version>5.22.0</version> <!-- 原书示例版本 --> </dependency> <dependency> <groupId>com.h2database</groupId> <artifactId>h2</artifactId> <version>1.4.200</version> <!-- 内存数据库，免安装 --> </dependency>

编译命令：

mvn clean install # 构建成功即表示依赖就绪

---

三、配置“能源核心”——数据库连接 1. 创建activiti.cfg.xml文件 <beans xmlns="http:// .springframework.org/schema/beans"...> <!-- 数据库配置 --> <bean id="dataSource" class="org.h2.jdbcx.JdbcDataSource"> <property name="URL" value="jdbc:h2:mem:activiti;DB_CLOSE_DELAY=1000"/> <property name="user" value="sa"/> <property name="password" value=""/> </bean> <!-- 流程引擎配置 --> <bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration"> <property name="dataSource" ref="dataSource"/> <property name="databaseSchemaUpdate" value="true"/> <!-- 自动建表 --> </bean> </beans>

关键参数解析：

databaseSchemaUpdate=true：启动时自动创建或更新表结构，开发环境神器！

---

四、启动“引擎点火”——初始化流程引擎 1. Java代码初始化 public class EngineStarter { public static void main(String[] args) { // 加载activiti.cfg.xml配置 ProcessEngine engine = ProcessEngineConfiguration .createProcessEngineConfigurationFromResource("activiti.cfg.xml") .buildProcessEngine(); System.out.println("Activiti引擎启动成功！版本：" + engine.VERSION); System.out.println("自动创建表数量：" + engine.getManagementService() .getTableCount().getTables().size()); } } 2. 运行结果验证 Activiti引擎启动成功！版本：5.22.0 自动创建表数量：28 # 看到此数字说明数据库表创建成功

趣味问答❓： Q：如果databaseSchemaUpdate设为false会怎样？ A：引擎启动失败，提示表不存在！需要手动执行SQL脚本初始化数据库。

---

五、“初号机”测试——部署并运行第一个流程 1. 创建BPMN文件

在src/main/resources下新建leave.bpmn（流程定义文件，第三章详解）。

2. 代码部署与启动流程 RepositoryService repositoryService = engine.getRepositoryService(); // 部署流程图 Deployment deployment = repositoryService.createDeployment() .addClasspathResource("leave.bpmn") .deploy(); RuntimeService runtimeService = engine.getRuntimeService(); // 启动流程实例 ProcessInstance instance = runtimeService.startProcessInstanceByKey("leaveProcess"); System.out.println("流程实例ID：" + instance.getId());

预期输出：

流程实例ID：2501 # 表示第一个流程实例已启动

---

六、避坑指南——环境搭建常见“雷区” 1. 依赖冲突

症状：ClassNotFoundException或NoSuchMethodError。 解法：用mvn dependency:tree排查冲突，排除重复依赖。

2. 数据库连接失败

症状：Connection refused或Unknown database。 检查项：

H2的URL格式是否正确（jdbc:h2:mem:activiti）。MySQL用户权限是否开放远程连接。

---

七、课后挑战——巩固你的“车间”

选择题：databaseSchemaUpdate参数设置为false时，如何初始化表结构？ A. 手动执行activiti.mysql.create.sql B. 引擎自动创建 C. 不需要表结构

实战题：尝试将数据库切换为MySQL，修改activiti.cfg.xml配置并成功启动引擎。

---