当前位置: 代码迷 >> 综合 >> Activiti7+SpringBoot 详细教程
  详细解决方案

Activiti7+SpringBoot 详细教程

热度:132   发布时间:2023-09-14 11:57:04

Activiti7.0+SpringBoot 教程

文章目录

    • 一. Activiti相关概念
      • 1. Activiti介绍
      • 2. 核心类
        • 2.1 ProcessEngine
        • 2.2 服务(Service)类
          • 2.2.1 TaskService
          • 2.2.2 RepositoryService
          • 2.2.3 RuntimeService
          • 2.2.3 HistoryService
        • 2.3 CommandContextIntercepter或CommandExecutor
        • 2.4 核心业务对象
      • 3. 上下文组件(Context)
        • 3.1 CommandContext
        • 3.2 ProcessEngineConfigurationImpl
        • 3.3 ExecutionContext
        • 4. 持久化组件
        • 5. Event-Listener组件
        • 6. Cache组件
        • 7. 异步执行组件
        • 8. PVM:Process Virtal Machine
    • 二. Eclipse插件安装:
    • 三. 项目搭建
      • 1. 新建Spring Boot工程
      • 2. 引入Activiti相关依赖
      • 3. 创建流程图
      • 4. 启动工程
      • 5. 修改配置
        • 5.1 添加MySQL依赖
        • 5.2 修改数据库
        • 5.3 Activiti相关配置
        • 5.4 附上application.yml完整配置:
        • 5.5 启动工程
      • 6. 编写实例
        • 6.1 引入Thymeleaf依赖,(前端使用Thymeleaf的配置已经在application.yml中)
        • 6.2 创建Controller控制器
        • 6.3 流程跟踪与流程图展示
        • 6.4 附上DemoController完整代码
      • 7. 效果

一. Activiti相关概念

1. Activiti介绍

????Activiti是基于Apache许可的开源BPM平台,创始人Tom Baeyens原是JBPM架构师,可以理解为与JBPM出自同一祖师爷。它提供了Eclipse插件,开发可以通过插件直接绘制业务流程图。基于Spring,ibatis等框架,并在此之上构建了非常清晰的开发框架。是由Alfresco软件发布的业务流程管理(BPM)框架,它是覆盖了业务流程管理、工作流、服务协作等领域的一个开源的、灵活的、易扩展的可执行流程语言框架。 本文基于Activiti7的Activiti Core,基于Spring Boot做简单学习总结。(Activiti最新版本向微服务这边靠齐了,并分Activiti Core与Activiti Cloud两块,Activiti Cloud还没研究)

2. 核心类

2.1 ProcessEngine

????流程引擎的抽象,可以通过此类获取需要的所有服务。

2.2 服务(Service)类

????通过ProcessEngine获取,Activiti将不同生命周期的服务封装在不同Service中,包括定义、部署、运行。通过服务类可获取相关生命周期中的服务信息。

2.2.1 TaskService

????流程运行过程中,每个任务节点的相关操作接口,如complete,delete,delegate等。

2.2.2 RepositoryService

????流程定义和部署相关的存储服务。

2.2.3 RuntimeService

????流程运行时相关的服务,如根据流程好启动流程实例startProcessInstanceByKey。

2.2.3 HistoryService

????历史记录相关服务接口。

2.3 CommandContextIntercepter或CommandExecutor

????Activiti使用命令模式作为基础开发模式,如Service中调用的各个方法都对应相应的命令对象。Service将请求委托给命令对象,命令对象来命令接受者,接受者接收后执行并返回结果。而CommandContextIntercepter的作用是拦截所有命令,并在命令前后执行一些公共方法。

2.4 核心业务对象

????org.activiti.engine.impl.persistence.entity包下的类,包括Task,ProcessInstance,Execution等。会根据不同职责实现相应接口的方法(如需要持久化则继承PersistentObject接口),与传统的实体类不同。

3. 上下文组件(Context)

????用来保存生命周期比较长,全局性的信息,类似Application,主要包括如下三类。

3.1 CommandContext

????命令上下文,保存每个命令必要的资源,如持久化需要的session。

3.2 ProcessEngineConfigurationImpl

????流程引擎相关配置信息,整个引擎全局的配置信息,如数据源DataSource等。该对象为单例,在流程引擎创建的时候初始化。

3.3 ExecutionContext

????持有ExecutionEntity对象。

4. 持久化组件

????Activiti使用ibatis作OR映射,并在此基础上增加设计了自己的持久化框架。在流程引擎创建时初始化。顶层接口Session、SessionFactory。Session有两个实现类:DbSqlSession,负责sql表达式的执行。AbstractManager负责对象的持久化操作。SessionFactory有两个实现类:DbSqlSessionFactory负责DbSqlSession相关操作,GenericManagerFactory负责AbstractManager相关操作。

5. Event-Listener组件

????Activiti允许客户代码介入流程执行,提供了事件监听组件。监听的事件类型可以分为TaskListener、JavaDelegate、Expression、ExecutionListener。ProcessEngineConfigurationImpl持有DelegateInterceptor的某个实例,方便调用handleInvocation。

6. Cache组件

????DbSqlSession中有cache的实现,Activiti基于List和Map来做缓存。如查询时先查缓存,没有则直接查询并放入缓存。

7. 异步执行组件

????Activiti可以执行任务,JobExecutor为启核心类,JobExecutor包含三个主要属性:JobAcquisitionThread,BlockingQueue,ThreadPoolExecutor。方法ProcessEngines在引擎启动时调用JobExecutor.start,JobAcquisitionThread 线程即开始工作,其run方法不断循环执行AcquiredJobs中的job,执行一次后线程等待一定时间直到超时或者JobExecutor.jobWasAdded方法,因为有新任务而被调用。

8. PVM:Process Virtal Machine

????流程虚拟机API暴露了流程虚拟机的POJO核心,流程虚拟机API描述了一个工作流流程必备的组件,这些组件包括:
????PvmProcessDefinition:流程的定义,形象点说就是用户画的那个图。静态含义。
????PvmProcessInstance:流程实例,用户发起的某个PvmProcessDefinition的一个实例,动态含义。
????PvmActivity:流程中的一个节点
????PvmTransition:衔接各个节点之间的路径,形象点说就是图中各个节点之间的连接线。
????PvmEvent:流程执行过程中触发的事件

二. Eclipse插件安装:

????我的Eclipse版本如下:
Activiti7+SpringBoot 详细教程
????下载离线安装包(在线安装始终失败,应该出于网络限制),地址:http://www.activiti.org/designer/archived/activiti-designer-5.18.0.zip
????离线安装包安装安装依然提示相关包找不到,于是下载另外三个依赖包(org.eclipse.emf.transaction_1.4.0.v20100331-1738.jar、org.eclipse.emf.validation_1.7.0.201306111341.jar、org.eclipse.emf.workspace_1.5.1.v20120328-0001.jar,在Maven仓库可以找到),放到Eclipse的plugin目录下,继续安装,如下:
Activiti7+SpringBoot 详细教程
????确定后勾选相关选项,完成安装,重启Eclipse,New->Other
Activiti7+SpringBoot 详细教程
????出现以上标志,则安装完成。

三. 项目搭建

1. 新建Spring Boot工程

????(我的Eclipse已经安装Spring Boot插件)
Activiti7+SpringBoot 详细教程
????然后Next->Next…->Finish即可,然后改application.properties为application.yml(个人习惯)
Activiti7+SpringBoot 详细教程

2. 引入Activiti相关依赖

????在pom属性中定义版本号,并添加Activiti相关依赖:

<activiti-dependencies.version>7.0.56</activiti-dependencies.version>

     
  • 1
<dependencyManagement><dependencies><dependency><groupId>org.activiti.dependencies</groupId><artifactId>activiti-dependencies</artifactId><version>${activiti-dependencies.version}</version><scope>import</scope><type>pom</type></dependency></dependencies>
</dependencyManagement>

     
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
<dependency><groupId>org.activiti</groupId><artifactId>activiti-spring-boot-starter</artifactId>
</dependency>

     
  • 1
  • 2
  • 3
  • 4

????由于Activiti默认使用H2数据库,所以需添加H2数据库支持(这里使用此SpringBoot版本默认1.4.197):

<dependency><groupId>com.h2database</groupId><artifactId>h2</artifactId>
</dependency>

     
  • 1
  • 2
  • 3
  • 4

????出现错误:Missing artifact org.activiti:activiti-spring-boot-starter:jar:7.0.56

Activiti7+SpringBoot 详细教程
????添加私服仓库地址:

<repositories><repository><id>alfresco</id><name>Activiti Releases</name><url>https://artifacts.alfresco.com/nexus/content/repositories/activiti-releases/</url><releases><enabled>true</enabled></releases></repository>
</repositories>

     
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10

Activiti7+SpringBoot 详细教程
????错误消失。

3. 创建流程图

????在此版本Activiti+SpringBoot,默认加载/processes/目录下流程,于是在resources下新建processes目录,并在目录下new->Other,如下:
Activiti7+SpringBoot 详细教程
????使用Activiti图编辑工具打开,创建如下流程(创建过程在此不介绍,就是右侧工具栏的运用):
Activiti7+SpringBoot 详细教程

4. 启动工程

????看日志:
Activiti7+SpringBoot 详细教程
????从日志中可以看出,流程引擎已经默认创建,并可以看到使用的默认数据源是H2的数据源,我们创建的流程也已经部署。

5. 修改配置

????在正常使用中,一般系统会有自己的数据库,而不会采用默认内存的H2数据库,这里以MySQL为例。修改application.yml。

5.1 添加MySQL依赖

<!--使用mysql数据库,导入mysql驱动-->
<dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId>
</dependency>

     
  • 1
  • 2
  • 3
  • 4
  • 5

5.2 修改数据库

spring:##数据库连接信息datasource:# 数据源配置url: jdbc:mysql://127.0.0.1:3306/activity?useUnicode=true&characterEncoding=utf-8&useSSL=falseusername: rootpassword: rootdriver-class-name: com.mysql.jdbc.Driver# SQLException: XAER_INVAL: Invalid arguments (or unsupported command)问题xa:properties:pinGlobalTxToPhysicalConnection: trueuseServerPrepStmts: true

     
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13

5.3 Activiti相关配置

  # 参考配置https://www.cnblogs.com/liaojie970/p/8857710.htmlactiviti:# 自动建表database-schema: ACTIVITIdatabase-schema-update: truehistory-level: fulldb-history-used: true

     
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7

????注意:
????database-schema-update表示启动时检查数据库表,不存在则创建
????history-level表示哪种情况下使用历史表,这里配置为full表示全部记录历史,方便绘制流程图
????db-history-used为true表示使用历史表,如果不配置,则工程启动后可以检查数据库,只建立了17张表,历史表没有建立,则流程图及运行节点无法展示(暂未找到可行方式)

5.4 附上application.yml完整配置:

# 服务配置
server:display-name: actdemoport: 8085