虚谷文档 v1.0.1

适用虚谷数据库版本

v12.9



适用虚谷数据库版本

v12.9


activiti 使用手册 ​

📄字数 1.8K
👁️阅读量 加载中...

本文将介绍在 spring-boot-web 应用中如何使用 activiti v5.2.1-xugu 连接 XuguDB，并测试在虚谷数据库部署 BPMN 模型、开启、处理流程实例等功能，以及UI组件功能介绍。

框架名称适配起始版本官网地址源框架下载地址XuguDB框架下载demo程序地址
activiti5.2.1activiti官网activiti源码版本发布xugu-activiti-demo

提示

其他支持版本可详见版本发布列表

一、使用说明 ​

1.1 下载 activiti 虚谷适配源码 ​

虚谷对 activiti 的下载方式有两种，通过 git 命令和 github 下载功能。

1.1.1 方式一：克隆 activiti 代码到本地 ​

  1. 访问虚谷数据库开放源代码仓库，使用命令 git clone <repository-url> 通过 HTTPS 或者 SSH 克隆到本地。

    activiti仓库克隆地址图 1.1 activiti仓库克隆地址

1.1.2 方式二：下载 activiti 代码到本地 ​

  1. 访问虚谷数据库开放源代码仓库，选择所需版本分支。

    activiti仓库分支选择图 1.2 activiti仓库分支选择

  2. 直接下载当前分支源码（本地未安装 Git）。

    activiti分支代码下载图 1.3 activiti分支代码下载

1.2 安装 activiti 到本地 Maven 仓库 ​

注意

activiti 模块较多，建议使用 Maven 将源码安装到本地仓库

  1. 推荐使用 jdk 8 和 Maven 3.6.x 运行环境。

    Java环境检查图 1.4 Java环境检查

  2. 使用 IDEA 打开 activiti-5.2.1 项目，并使用 Maven 插件 install 进行本地仓库部署。出现 BUILD SUCCESS 即安装成功。

    activiti插件安装图 1.5 activiti插件安装

二、连接示例 ​

2.1 前提条件 ​

  • 已安装 JDK 1.8 和 Maven。
  • 已安装 IntelliJ IDEA。
  • 已安装 DBManager 或者 xgconsole。
  • 已部署 XuguDB 12.0.0 或有能连接访问的虚谷数据库实例。

提示

本文档示例程序运行使用的软件为IntelliJ IDEA 2025.1.2 (Community Edition)，也可以按照自己的喜好选择其它开发工具运行此示例程序。

2.2 操作步骤 ​

  • 导入 xugu-activiti-demo 项目到 IDEA 中。
  • 修改 xugu-activiti-demo 项目中数据库连接信息。
  • 运行 xugu-activiti-demo 项目。

提示

本文是在Windows环境中进行操作说明的，若使用的是其它操作环境，那么与本文中的步骤可能存在不同。

2.2.1 导入 xugu-activiti-demo 项目到 IDEA ​

  1. 参考 IntelliJ IDEA 官方文档，导入项目。

    1. 启动 IntelliJ IDEA。 如果欢迎屏幕打开，请选择左侧栏目中项目（Projects）-> 右侧选项打开（Open）。 否则，请转到左上角主菜单的 文件（File）-> 打开（Open）。
    2. 在打开的对话框中，选择下载的源代码、库目录下的二级目录 xugu-activiti-demo，然后点击 Select Folder 打开。

  2. 项目结构设置

    1. 更改项目 SDK 设置：参考 SDK | IntelliJ IDEA 文档，请点击右上角工具栏上的齿轮⚙设置按钮并选择项目结构按钮（Project Structure...）。 或者，前往 文件（File）-> 项目结构（Project Structure...） 或按 Ctrl+Alt+Shift+S。

      xugu-activiti-demo项目JDK设置图 2.1 xugu-activiti-demo项目JDK设置

    2. 项目 Maven 设置：参考 Maven | IntelliJ IDEA 文档，文件 -> 设置 -> 构建、执行、部署 -> 构建工具 -> Maven。

      xugu-activiti-demo项目Maven设置图 2.2 xugu-activiti-demo项目Maven设置

2.2.2 修改 xugu-activiti-demo 项目中数据库连接信息 ​

修改 xugu-activiti-demo/src/main/resources/activiti.cfg.xml 文件中的数据库连接信息。

xugu-activiti-demo配置详情图 2.3 xugu-activiti-demo配置详情

  • 示例代码

    xml
     <property name="jdbcDriver" value="com.xugu.cloudjdbc.Driver"/>
 <property name="jdbcUrl" value="jdbc:xugu://localhost:5137/activiti_cae?useUnicode=true&amp;uselike=true&amp;characterEncoding=utf-8&amp;serverTimezone=UTC&amp;nullCatalogMeansCurrent=true&amp;keyword_filter=LINK"/>
 <property name="jdbcUsername" value="SYSDBA"/>
 <property name="jdbcPassword" value="SYSDBA"/>

2.2.3 运行 xugu-activiti-demo 项目 ​

  1. 在项目路径 xugu-activiti-demo/src/test/java/com/xugu/test/TestCreate.java 中运行测试类。

    xugu-activiti-demo运行路径图 2.4 xugu-activiti-demo运行路径

  2. 在 IDEA 的项目运行控制台观测运行过程和结果，可以看到 activiti 框架所需构建的 sql 脚本正在被逐一执行。

    xugu-activiti-demo运行结果图 2.5 xugu-activiti-demo运行结果

  3. 使用 DBManager 登录 xugu-activiti-demo 项目连接的数据库，查看表数据是否创建成功。

    验证运行结果图 2.6 验证运行结果