Flowable 用户指南教程

1. 项目目录结构及介绍

项目 qiudaoke/flowable-userguide 的目录结构如下：

.
├── docs                # 文档源代码
│   ├── conf.py         # Sphinx 配置文件
│   ├── index.rst       # 主页文档
│   └── ...
├── flowable-source     # Flowable 源码
│   ├── bin             # 启动脚本
│   ├── lib             # 依赖库
│   ├── src             # 源码目录
│   └── ...
├── scripts             # 辅助脚本
│   ├── db              # 数据库操作相关脚本
│   ├── deploy          # 部署相关脚本
│   └── ...
└── README.md           # 项目说明

docs 目录包含项目的所有文档资源，使用 Sphinx 构建。

flowable-source 包含了 Flowable 开源项目的源代码，包括启动脚本、库文件和源码文件等。

scripts 存放用于数据库初始化、部署和其他辅助任务的脚本。

README.md 文件提供了项目的简要说明和快速入门指导。

2. 项目的启动文件介绍

在 flowable-source/bin 目录下，通常会有类似于以下的启动脚本：

• start.sh: Linux 或 macOS 上启动 Flowable 服务的 shell 脚本。
• startup.bat: Windows 系统上启动 Flowable 的批处理命令。

这些脚本会设置环境变量，加载库文件，并调用适当的 JVM 命令来启动 Flowable 引擎及相关组件。

例如，在 start.sh 中可能会有类似以下的片段来启动服务：

#!/bin/bash
cd $FLOWABLE_HOME
java -jar lib/flowable-engine.jar

这里 $FLOWABLE_HOME 指向 Flowable 安装目录，flowable-engine.jar 是 Flowable 的可执行 JAR 文件。

3. 项目的配置文件介绍

Flowable 使用 flowable.cfg.xml 配置文件来控制引擎的行为。该文件通常位于 flowable-source/conf 目录下，或者在运行时指定路径。主要配置项包括：

• databaseType: 设置使用的数据库类型，如 mysql, oracle, h2 等。
• jdbcUrl: 数据库连接 URL。
• jdbcDriver: JDBC 驱动类名。
• jdbcUsername: 数据库用户名。
• jdbcPassword: 数据库密码。
• databaseSchemaUpdate: 是否自动更新数据库 schema，默认值为 false，在升级或首次安装时可设为 true 来自动创建或更新表。

例如：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">

<beans>
    <bean id="processEngineConfiguration" class="org.flowable.engine.impl.cfg.StandaloneProcessEngineConfiguration">
        <property name="databaseType" value="mysql"/>
        <property name="jdbcUrl" value="jdbc:mysql://localhost:3306/flowable"/>
        <property name="jdbcDriver" value="com.mysql.jdbc.Driver"/>
        <property name="jdbcUsername" value="root"/>
        <property name="jdbcPassword" value="password"/>
        <!-- Other properties... -->
    </bean>
</beans>

如果你计划使用 Spring Boot 整合 Flowable，配置文件可能位于 src/main/resources/application.yml 中，采用 YAML 格式。

请注意，这里的描述是基于一般的开源项目结构和流程，具体 qiudaoke/flowable-userguide 项目可能有所不同，需参考实际项目的文件和文档。