# activiti-test

**Repository Path**: oszhugc/activiti-test

## Basic Information

- **Project Name**: activiti-test
- **Description**: springboot结合activiti6 以及集成activiti在线编辑器
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 23
- **Created**: 2020-04-15
- **Last Updated**: 2021-11-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



写在前面：从《库表与服务》这篇中的‘服务’可以看出来，processEngine是核心关键 通过流程引擎创建出对应需要的服务。从使用RepositoryService部署流程 可以创建模型并转化成部署文件进行部署，部署完成启动后 可以使用RuntimeService查看运行状态的示例，接下来任务的流程可以使用TaskService进行任务的签收 办理 指派。最后 可以使用HistoryService查看所有以往的流程实例 任务等信息。

环境：springboot2 ，activi6，mysql 5.7

项目地址：
码云： https://gitee.com/belonghuang/activiti-test
github： https://github.com/Blankwhiter/activiti-test 

项目关键目录一览：
![在这里插入图片描述](https://img-blog.csdnimg.cn/20190814145007467.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbG9uZ2h1YW5nMTU3NDA1,size_16,color_FFFFFF,t_70)

 # 一、springboot集成activiti
### 1 pom.xml jar包环境
```xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.0.3.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.example</groupId>
    <artifactId>activiti-test</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>activiti-test</name>
    <description>Demo project for Spring Boot</description>

    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <!--aop 拦截-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-aop</artifactId>
            <version>2.0.3.RELEASE</version>
            <scope>compile</scope>
        </dependency>
        <!--web模块-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!--spring-boot集成mybatis-->
        <dependency>
            <groupId>com.ruijc</groupId>
            <artifactId>spring-boot-starter-mybatis</artifactId>
            <version>3.2.2</version>
        </dependency>
        <!--lombok -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <!--test 用例-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <!--druid 连接池-->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid-spring-boot-starter</artifactId>
            <version>1.1.10</version>
        </dependency>
        <!--mysql-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.43</version>
            <!--<version>8.0.15</version>-->
        </dependency>
        <!--activiti基础包-->
        <dependency>
            <groupId>org.activiti</groupId>
            <artifactId>activiti-spring-boot-starter-basic</artifactId>
            <version>6.0.0</version>
        </dependency>

        <dependency>
            <groupId>org.activiti</groupId>
            <artifactId>activiti-json-converter</artifactId>
            <version>6.0.0</version>
        </dependency>
        <dependency>
            <groupId>org.apache.xmlgraphics</groupId>
            <artifactId>batik-transcoder</artifactId>
            <version>1.7</version>
        </dependency>

        <dependency>
            <groupId>org.apache.xmlgraphics</groupId>
            <artifactId>batik-codec</artifactId>
            <version>1.7</version>
        </dependency>
 
        <!--分页插件 4.1.5 版本以上修复 selectProvider不兼容问题-->
        <dependency>
            <groupId>com.github.pagehelper</groupId>
            <artifactId>pagehelper</artifactId>
            <version>4.1.5</version>
        </dependency>
        <!--common-->
        <!--<dependency>-->
            <!--<groupId>org.apache.commons</groupId>-->
            <!--<artifactId>commons-lang3</artifactId>-->
            <!--<version>3.0</version>-->
        <!--</dependency>-->
        <!--热部署-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <optional>true</optional>
        </dependency>

    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <!--设置外部打包-->
                <configuration>
                    <includeSystemScope>true</includeSystemScope>
                </configuration>
            </plugin>

            <!--mybatis generator begin-->
            <plugin>
                <!--Mybatis-generator插件,用于自动生成Mapper和POJO-->
                <groupId>org.mybatis.generator</groupId>
                <artifactId>mybatis-generator-maven-plugin</artifactId>
                <version>1.3.5</version>
                <configuration>
                    <!--配置文件的位置-->
                    <configurationFile>src/main/resources/generator/mybatis_generator_config.xml
                    </configurationFile>
                    <verbose>true</verbose>
                    <overwrite>true</overwrite>
                </configuration>
                <executions>
                    <execution>
                        <id>Generate MyBatis Artifacts</id>
                        <phase>deploy</phase>
                        <goals>
                            <goal>generate</goal>
                        </goals>
                    </execution>
                </executions>

                <dependencies>
                    <!--防止找不到驱动 报出如下异常：Exception getting JDBC Driver: com.mysql.jdbc.Driver-->
                    <dependency>
                        <groupId>mysql</groupId>
                        <artifactId>mysql-connector-java</artifactId>
                        <version>5.1.43</version>
                    </dependency>

                    <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
                    <dependency>
                        <groupId>org.mybatis</groupId>
                        <artifactId>mybatis</artifactId>
                        <version>3.4.4</version>
                    </dependency>
                    <!-- mybatis-generator-core 反向生成java代码-->
                    <dependency>
                        <groupId>org.mybatis.generator</groupId>
                        <artifactId>mybatis-generator-core</artifactId>
                        <version>1.3.5</version>
                    </dependency>

                </dependencies>

            </plugin>
            <!--mybatis generator end-->

        </plugins>
    </build>

</project>

```

### 2.application.properties 配置数据库连接、 activiti、 静态资源路径等属性
```xml

server.port=8083

#访问的静态资源
spring.mvc.view.prefix=classpath:/static/

#数据库连接
spring.datasource.type=com.alibaba.druid.pool.DruidDataSource
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/act?serverTimezone=Hongkong&useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=false
spring.datasource.username=root
spring.datasource.password=111111

# 下面为连接池的补充设置，应用到上面所有数据源中
# 初始化大小，最小，最大
spring.datasource.druid.initial-size=5
spring.datasource.druid.min-idle=5
spring.datasource.druid.max-active=20
# 配置获取连接等待超时的时间
spring.datasource.druid.max-wait=60000
# 配置间隔多久才进行一次检测，检测需要关闭的空闲连接，单位是毫秒
spring.datasource.druid.time-between-eviction-runs-millis=60000
# 配置一个连接在池中最小生存的时间，单位是毫秒
spring.datasource.druid.min-evictable-idle-time-millis=300000
spring.datasource.druid.validation-query=SELECT 1 FROM DUAL
spring.datasource.druid.test-while-idle=true
spring.datasource.druid.test-on-borrow=false
spring.datasource.druid.test-on-return=false
# 打开PSCache，并且指定每个连接上PSCache的大小
spring.datasource.druid.pool-prepared-statements=true
spring.datasource.druid.max-pool-prepared-statement-per-connection-size=20
# 配置监控统计拦截的filters，去掉后监控界面sql无法统计，'wall'用于防火墙
spring.datasource.druid.filter.commons-log.connection-logger-name=stat,wall,log4j
spring.datasource.druid.filter.stat.log-slow-sql=true
spring.datasource.druid.filter.stat.slow-sql-millis=2000
# 通过connectProperties属性来打开mergeSql功能；慢SQL记录
spring.datasource.druid.connect-properties.=druid.stat.mergeSql=true;druid.stat.slowSqlMillis=5000
# 合并多个DruidDataSource的监控数据
spring.datasource.druid.use-global-data-source-stat=true
#druid 登陆配置
spring.datasource.druid.web-stat-filter.enabled=false
spring.datasource.druid.stat-view-servlet.login-username=admin
spring.datasource.druid.stat-view-servlet.login-password=admin


#mybatis 配置
mybatis.mapper-locations=classpath:mappers/*Mapper.xml
mybatis.type-aliases-package=com.example.activititest.po
mybatis.check-config-location=true 
mybatis.config-location=classpath:mybatis-config.xml

# activiti 自动部署验证设置:true-开启（默认）、false-关闭
spring.activiti.check-process-definitions=false
# activiti 当自动检查 并更新数据库接表不存在则进行创建
spring.activiti.database-schema-update=true


#监控地址端口
management.server.port=7000

#springboot2.0之后，在Http环境下将默认的endpoint只设置为info和health，要想开启其他的监控功能，需要手动配置
management.endpoints.web.exposure.include=*

#请求连接前缀 默认是/actuator
management.endpoints.web.base-path=/actuator

```


### 3.ActivitiTestApplication 启动类 需要去除org.activiti.spring.boot.SecurityAutoConfiguration
```java
import org.activiti.spring.boot.SecurityAutoConfiguration;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

/**
 * 配置mybatis扫描包 去除exclude = SecurityAutoConfiguration.class ，
 * org.activiti.spring.boot.SecurityAutoConfiguration会导致
 * Invocation of init method failed; nested exception is java.lang.ArrayStoreException: sun.reflect.annotation.TypeNotPresentExceptionProxy
 */
@SpringBootApplication(exclude = SecurityAutoConfiguration.class)
@MapperScan(basePackages = "com.example.activititest.dao")
public class ActivitiTestApplication {

    public static void main(String[] args) {
        SpringApplication.run(ActivitiTestApplication.class, args);
    }

}

```


### 4.将流程在线设计器放置再static目录下
此步骤 请从源码中拷贝。
需要注意的是<font color=red>
1.activiti-test\src\main\resources\static\editor-app\app-cfg.js 配置请求的根路径
2.activiti-test\src\main\resources\static\editor-app\configuration\url-config.js 配置了 模型json，获得模具集合，保存模型</font>

其他代码将不再赘述，如有问题，请再评论区写在疑问。


# 二、接口演示

## 案例测试：
1.流程图展示：
![在这里插入图片描述](https://img-blog.csdnimg.cn/20190814151022534.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbG9uZ2h1YW5nMTU3NDA1,size_16,color_FFFFFF,t_70)
*注：此图是使用Idea中的actiBPM插件*

2.示例请假流程说明：员工发起流程，经有人事（group：affair）进行审核： 如审核不通过，则结束流程，否则审核通过则判断审核天数 ：如天数小于等于3天交予经理（group：manager）审批  而后结束流程，超过三天 则交予总经理（group：president）审核 而后结束流程。
*注：角色后面跟的group是对应每个角色的分组标识。用于查看待签任务时候，查看属于自己组别的可签收的任务*
### 1.部署流程文件
测试ActivitiDefineController下的deploy方法 经测试可以看到返回部署成功
![在这里插入图片描述](https://img-blog.csdnimg.cn/20190814153646122.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbG9uZ2h1YW5nMTU3NDA1,size_16,color_FFFFFF,t_70)


### 2.部署成功了，当然可以查看对应的部署列表了
测试ActivitiDefineController下的list方法 经测试可以看到返回列表数据
![在这里插入图片描述](https://img-blog.csdnimg.cn/2019081415460261.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbG9uZ2h1YW5nMTU3NDA1,size_16,color_FFFFFF,t_70)

### 3.当然了这样可能不够直观 ，可以通过列表中的 部署id，查看流程图
测试ActivitiDefineController下的viewProcessImage方法 经测试可以看到返回定义的流程图
![在这里插入图片描述](https://img-blog.csdnimg.cn/20190814154920761.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbG9uZ2h1YW5nMTU3NDA1,size_16,color_FFFFFF,t_70)

### 4.查看该这个流程图觉得没有问题了，我们就准备启动该流程定义，创建流程实例（即员工张三发起请假）。
测试ActivitiDefineController下的startProcessInstanceById方法 经测试可以看到返回成功（这里方便测试将assignee-‘当前用户’，由前台传入，后面将不再赘述。 读者可将用户id做为assignee，此文为了直观使用名称作为assignee）
![在这里插入图片描述](https://img-blog.csdnimg.cn/20190814155928892.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbG9uZ2h1YW5nMTU3NDA1,size_16,color_FFFFFF,t_70)
*注：流程图人事不同意那条线 单词是错误的。供后面在线流程编辑器进行修改使用。*

### 5.人事审核过程：人事角色赵四（group：affair）登陆，可查看待签任务
测试ActivitTaskController下的claimList方法 经测试可以看到返回列表数据
![在这里插入图片描述](https://img-blog.csdnimg.cn/20190814162639888.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbG9uZ2h1YW5nMTU3NDA1,size_16,color_FFFFFF,t_70)
*注：这里多说一句可以看到catalog这里是null，可以开始在流程部署文件中直接定义，这样流程定义等就可以按照catelog进行查找了。*

### 6.人事赵四看到有可签收的任务，进行签收
测试ActivitTaskController下的claim方法 经测试可以看到返回成功
![在这里插入图片描述](https://img-blog.csdnimg.cn/20190814170040796.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbG9uZ2h1YW5nMTU3NDA1,size_16,color_FFFFFF,t_70)

*注：这是签收列表中就没有这一条记录，数据往待办任务走*
### 7.赵四签收了任务，现在就可以在待办任务中 找到刚才签收的任务了
测试ActivitTaskController下的todoList方法 经测试可以看到返回列表数据
![在这里插入图片描述](https://img-blog.csdnimg.cn/20190814170638816.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbG9uZ2h1YW5nMTU3NDA1,size_16,color_FFFFFF,t_70)

### 8.赵四找到了待办任务，进行审批
测试ActivitTaskController下的complete方法 经测试可以看到返回成功（需要注意这里人事需要进行审批，审批通过才会有后面的流程即需要传参agree=‘yes’， agress=‘yes’， days=3）
![在这里插入图片描述](https://img-blog.csdnimg.cn/20190814174304417.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbG9uZ2h1YW5nMTU3NDA1,size_16,color_FFFFFF,t_70)
注：这里是将 <font color=blue>不同意</font>那条线的判断参数错将<font color=red>agree<font>写成</font color=red>agress</font> 此处留下一个伏笔将会用到模型转换并使用流程设计器进行修改（此处暂不赘述），完成该任务，待办列表中就没有了该条记录，数据将往后一个流程经理审批进行签收，读者也可以将days大于3，数据将往总经理审批。

### 9.经理审核流程：经理角色王五（group：manager）登录，可查看待签任务 
测试ActivitTaskController下的claimList方法 经测试可以看到返回列表数据
![在这里插入图片描述](https://img-blog.csdnimg.cn/20190814201214934.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbG9uZ2h1YW5nMTU3NDA1,size_16,color_FFFFFF,t_70)

### 10.王五签收了任务，而后从待办任务中 可查看该任务
测试ActivitTaskController下的claim方法 经测试可以看到返回成功
![在这里插入图片描述](https://img-blog.csdnimg.cn/20190814201532845.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbG9uZ2h1YW5nMTU3NDA1,size_16,color_FFFFFF,t_70)

### 11.王五找到待办任务
测试ActivitTaskController下的todoList方法 经测试可以看到返回列表数据
![在这里插入图片描述](https://img-blog.csdnimg.cn/20190814201932722.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbG9uZ2h1YW5nMTU3NDA1,size_16,color_FFFFFF,t_70)

### 12.王五完成任务，即结束了流程
测试ActivitTaskController下的complete方法 经测试可以看到返回成功
![在这里插入图片描述](https://img-blog.csdnimg.cn/20190814202334664.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbG9uZ2h1YW5nMTU3NDA1,size_16,color_FFFFFF,t_70)


### 13.在上诉任务开始的时候，张三突然想看自己发起流程的进度情况了
测试ActivitTaskController下的sentList方法 经测试可以看到返回列表数据
![在这里插入图片描述](https://img-blog.csdnimg.cn/20190814202716208.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbG9uZ2h1YW5nMTU3NDA1,size_16,color_FFFFFF,t_70)
*注：可以看到流程开始时间 结束时间 流程全部时间等信息*

### 14.或者某个人突然想查看自己参与过的办结流程记录
测试ActivitTaskController下的finishList方法 经测试可以看到返回列表数据（这里以赵四为例）
![在这里插入图片描述](https://img-blog.csdnimg.cn/20190814203203395.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbG9uZ2h1YW5nMTU3NDA1,size_16,color_FFFFFF,t_70)

### 15.或者查看流程所审批的流程过程
测试ActivitTaskController下的viewProgressPathImage方法 经测试可以看到返回流程轨迹图
![在这里插入图片描述](https://img-blog.csdnimg.cn/20190814203605540.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbG9uZ2h1YW5nMTU3NDA1,size_16,color_FFFFFF,t_70)

### 16.在发现部署文件有问题时候，我们可以转换成模型，用在线流程编辑器修改。
测试ActivitiDefineController下的convertToModel方法 经测试可以看到返回成功
![在这里插入图片描述](https://img-blog.csdnimg.cn/20190814204632955.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbG9uZ2h1YW5nMTU3NDA1,size_16,color_FFFFFF,t_70)

### 17.查看模型列表
测试ActivitModelController下的list方法 经测试可以看到返回列表数据
![在这里插入图片描述](https://img-blog.csdnimg.cn/20190814204838144.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbG9uZ2h1YW5nMTU3NDA1,size_16,color_FFFFFF,t_70)

### 18.使用线流程编辑器 将id传入
打开浏览器http://localhost:8083/modeler.html?modelId=2503 （这里涉及到ActivitiVisualController的方法，请看源码此处不再赘述）
![在这里插入图片描述](https://img-blog.csdnimg.cn/20190814205516929.gif)
*注：修改后保存，而后进行部署。*

### 19.流程编辑保存后进行部署生效，迭代版本
测试ActivitModelController下的deploy方法 经测试可以看到返回成功
![在这里插入图片描述](https://img-blog.csdnimg.cn/20190814210244242.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbG9uZ2h1YW5nMTU3NDA1,size_16,color_FFFFFF,t_70)

### 20.这时候再看流程定义，可以看到版本（version：2）迭代
测试ActivitiDefineController下的list方法 经测试可以看到返回列表数据
![在这里插入图片描述](https://img-blog.csdnimg.cn/20190814210254499.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbG9uZ2h1YW5nMTU3NDA1,size_16,color_FFFFFF,t_70)



写在最后：读者也可以用ActivitModelController中的save方法创建出模型，而后使用在线流程设计器画出流程部署，效果跟官网的样例是一样的。