若依框架，集成flowable工作流

Posted 2023-04-02 淡月斜阳

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了若依框架，集成flowable工作流相关的知识，希望对你有一定的参考价值。

参考文档：

flowable · 语雀

抄人家的代码:

https://gitee.com/tony2y/RuoYi-flowable.git

因为这是一个完整的项目，如果是空项目的话，直接下载就行了，已有项目移植。就可以往下看了，已调试通过。

效果：

或者：你可以看人家的演示系统：

若依管理系统

后端：创建一个ruoyi-flowable的包。原文件中部分domain mapper 在ruoyi-system下，为了方便管理，全部都给搞到ruoyi-flowable包下。最终结构如下。

需要移动的有

需要注意：

1.修改import 引用位置

2.修改mapper的命名空间

3.resource文件夹下，建立文件夹，必须一层一层建，先建mapper，再建flowable，不能直接mapper.flowable，会报错。

org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.ruoyi.flowable.mapper.FlowDeployMapper.selectDeployList

4.改ruoyi-flowable的pom文件，更新一下maven

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
	<parent>
		<artifactId>ruoyi</artifactId>
		<groupId>com.ruoyi</groupId>
		<version>3.8.3</version>
	</parent>
	<modelVersion>4.0.0</modelVersion>

	<artifactId>ruoyi-flowable</artifactId>

	<properties>
		<maven.compiler.source>8</maven.compiler.source>
		<maven.compiler.target>8</maven.compiler.target>
	</properties>

	<dependencies>
		<dependency>
			<groupId>com.ruoyi</groupId>
			<artifactId>ruoyi-framework</artifactId>
		</dependency>
		<dependency>
			<groupId>com.ruoyi</groupId>
			<artifactId>ruoyi-system</artifactId>
		</dependency>
		<dependency>
			<groupId>com.ruoyi</groupId>
			<artifactId>ruoyi-common</artifactId>
		</dependency>

		<!--常用工具类 -->
		<dependency>
			<groupId>org.apache.commons</groupId>
			<artifactId>commons-lang3</artifactId>
		</dependency>

		<!-- JSON工具类 -->
		<dependency>
			<groupId>com.fasterxml.jackson.core</groupId>
			<artifactId>jackson-databind</artifactId>
		</dependency>

<!--		&lt;!&ndash; 阿里JSON解析器 &ndash;&gt;-->
		<dependency>
			<groupId>com.alibaba</groupId>
			<artifactId>fastjson</artifactId>
		</dependency>

		<dependency>
			<groupId>org.projectlombok</groupId>
			<artifactId>lombok</artifactId>
			<optional>true</optional>
		</dependency>
		<dependency>
			<groupId>io.swagger</groupId>
			<artifactId>swagger-annotations</artifactId>
			<scope>compile</scope>
		</dependency>
		<dependency>
			<groupId>org.flowable</groupId>
			<artifactId>flowable-engine</artifactId>
			<scope>compile</scope>
		</dependency>

		<dependency>
			<groupId>org.flowable</groupId>
			<artifactId>flowable-spring-boot-starter-basic</artifactId>
		</dependency>

		<dependency>
			<!-- websocket -->
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-websocket</artifactId>
		</dependency>
		<dependency>
			<groupId>com.googlecode.aviator</groupId>
			<artifactId>aviator</artifactId>
			<version>5.3.1</version>
		</dependency>
		<dependency>
			<groupId>io.swagger</groupId>
			<artifactId>swagger-annotations</artifactId>
			<version>1.6.2</version>
			<scope>compile</scope>
		</dependency>
		<dependency>
			<groupId>com.baomidou</groupId>
			<artifactId>mybatis-plus-extension</artifactId>
			<version>3.5.1</version>
			<scope>compile</scope>
		</dependency>
		<dependency>
			<groupId>com.alibaba</groupId>
			<artifactId>fastjson</artifactId>
			<version>1.2.83</version>
			<scope>compile</scope>
		</dependency>
		<dependency>
			<groupId>xerces</groupId>
			<artifactId>xercesImpl</artifactId>
			<version>2.12.0</version>
		</dependency>
	</dependencies>


</project>

二、建立数据库表

因为移动了文件位置，会有一堆报错，处理一下。大概都是domain和mapper位置不一致引起的。然后运行后端，会自动建立flowable的相关数据表。但是有三张表是作者自己加的，参考sql，自己建立一下。

三、前端

1.src/components文件夹下，放这几个文件夹

2.src/views文件夹下，放flowable文件夹，添加api

3.public文件夹下加libs

4.utils文件夹下,覆盖generator文件夹下内容，另外加入的有几个文件@/utils/db @/utils/generator/drawingDefalut @/utils/loadBeautifier @/utils/loadMonaco @/utils/loadTinymce

以上，除了views/flowable,其余基本上都是Form Generator表单设计器里需要的文件。

form-generator: Element UI表单设计及代码生成器

5.覆盖views/tool/build文件夹

6.有些位置有变动，需要修改

修改IconsDialog.vue（因为没有加入@icons 这个文件夹）

7.配置路由

8.npm install，然后npm run dev

看看需要哪些组件

提示，让install这些的

@/utils/db @/utils/generator/drawingDefalut @/utils/loadBeautifier @/utils/loadMonaco @/utils/loadTinymce

一看，这些位置有没有这个文件，二检查哪些文件Improt引用了之些文件，可能引用位置需要修改。

例如，下面这里（都在VUE文件里，没几个，好找）。

另外，需要Npm install vkbeautify。会有提示，缺少什么安装什么。

9.跑起来以后。增加菜单（参考 sql中的写，或者参照演示系统的）

INSERT INTO `sys_menu` VALUES (2020, '流程管理', 0, 6, 'flowable', NULL, 1, 0, 'M', '0', '0', NULL, 'cascader', 'tony', '2021-03-25 11:35:09', '', NULL, '');
INSERT INTO `sys_menu` VALUES (2022, '流程定义', 2020, 2, 'definition', 'flowable/definition/index', 1, 0, 'C', '0', '0', '', 'job', 'tony', '2021-03-25 13:53:55', 'admin', '2021-03-29 09:39:07', '');
INSERT INTO `sys_menu` VALUES (2023, '任务管理', 0, 7, 'task', NULL, 1, 0, 'M', '0', '0', '', 'dict', 'tony', '2021-03-26 10:53:10', 'admin', '2021-03-29 09:37:40', '');
INSERT INTO `sys_menu` VALUES (2024, '待办任务', 2023, 2, 'todo', 'flowable/task/todo/index', 1, 1, 'C', '0', '0', '', 'cascader', 'admin', '2021-03-26 10:55:52', 'admin', '2021-03-30 09:26:36', '');
INSERT INTO `sys_menu` VALUES (2025, '已办任务', 2023, 3, 'finished', 'flowable/task/finished/index', 1, 1, 'C', '0', '0', '', 'time-range', 'admin', '2021-03-26 10:57:54', 'admin', '2021-03-30 09:26:50', '');
INSERT INTO `sys_menu` VALUES (2026, '我的流程', 2023, 1, 'process', 'flowable/task/process/index', 1, 1, 'C', '0', '0', NULL, 'guide', 'admin', '2021-03-30 09:26:23', '', NULL, '');
INSERT INTO `sys_menu` VALUES (2027, '表单配置', 2020, 2, 'form', 'flowable/task/form/index', 1, 0, 'C', '0', '0', 'flowable:form:list', 'form', 'admin', '2021-03-30 22:55:12', 'admin', '2021-04-03 18:50:54', '');
INSERT INTO `sys_menu` VALUES (2028, '新增', 2027, 1, '', NULL, 1, 0, 'F', '0', '0', 'flowable:form:add', '#', 'admin', '2021-07-07 14:23:37', '', NULL, '');
INSERT INTO `sys_menu` VALUES (2029, '删除', 2027, 3, '', NULL, 1, 0, 'F', '0', '0', 'flowable:form:remove', '#', 'admin', '2021-07-07 14:24:10', '', NULL, '');
INSERT INTO `sys_menu` VALUES (2030, '编辑', 2027, 2, '', NULL, 1, 0, 'F', '0', '0', 'flowable:form:edit', '#', 'admin', '2021-07-07 14:24:31', '', NULL, '');
INSERT INTO `sys_menu` VALUES (2031, '新增', 2026, 1, '', NULL, 1, 0, 'F', '0', '0', 'system:deployment:add', '#', 'admin', '2021-07-07 14:25:22', '', NULL, '');
INSERT INTO `sys_menu` VALUES (2032, '编辑', 2026, 2, '', NULL, 1, 0, 'F', '0', '0', 'system:deployment:edit', '#', 'admin', '2021-07-07 14:25:47', '', NULL, '');
INSERT INTO `sys_menu` VALUES (2033, '删除', 2026, 3, '', NULL, 1, 0, 'F', '0', '0', 'system:deployment:remove', '#', 'admin', '2021-07-07 14:26:02', '', NULL, '');
INSERT INTO `sys_menu` VALUES (2034, '查询', 2027, 4, '', NULL, 1, 0, 'F', '0', '0', 'flowable:form:query', '#', 'admin', '2021-07-08 14:05:22', '', NULL, '');

10.如果报404错误，比如点击按钮时。可能是router/index.js没有配置路由。或者是按钮的push与配置的路由不对应。这个看你自己的定义。

11.语法修改。报错如下、

看源文件，版本问题。

需要改成

同理，confirm，notify

同

可以搜索，批量替换。

查看Json,资源初始化中。报错

缺少了这个组件

表单配置，编辑器不显示

解决方案：下载表单设计器源码。用这个config文件覆盖

form-generator: Element UI表单设计及代码生成器

这里我使用了wangEditor，比较简单，另外以前搞过，不想再费事。效果如下

这个我已经修改了文件上传，基本继承了原来的quill Editor。你需要使用哪个组件，直接修改config配置就行。可以看我的另一篇集成wangEditor富文本的文章。

这里改成Editor,因为我已将原来的Editor替换成wangEditor，并全局挂载

基于若依的微服务快速开发框架(积木报表 + 工作流)

项目简介

基于若依Cloud的Jove-Fast微服务项目，主要集成了积木报表,工作流 flowable.
项目地址::https://gitee.com/wxjstudy/jove-fast

账号密码admin/Psitadmin
采用前后端分离的模式
后端采用Spring Boot、Spring Cloud & Alibaba。
注册中心、配置中心选型Nacos，权限认证使用Redis。
流量控制框架选型Sentinel.
分布式锁选型redisson.

表调整

部门表调整，增加了一列 describes，主要作用于积木设置当前登录用户部门描述

    @Override
    public Map<String, Object> getUserInfo(String token) 
        // 将所有信息存放至map 解析sql会根据map的键值解析,可自定义其他值
        Map<String, Object> map = new HashMap<>(20);
        LoginUser loginUser = tokenService.getLoginUser(token);
        map.put("sysUserCode",loginUser.getUsername());
        //设置当前日期（年月日）
        map.put("sysData",DateUtils.getDate());
        //设置昨天日期（年月日）
        map.put("sysYesterDay",DateUtils.getyesterday());
        //设置当前登录用户昵称
        map.put("sysUserName",loginUser.getSysUser().getNickName());
        //设置当前登录用户部门ID
        map.put("deptId",loginUser.getSysUser().getDeptId());
        //设置当前登录用户部门描述
        map.put("describe",loginUser.getSysUser().getDept().getDescribes());
        return map;

实现同一报表，不同角色的人看到的列数据不一样的结果，两个注解解决

    /**
     * 使用示例：在实现类方法上增加@ColAssign，用于标识需要返回修改的注入点
     *
     * @param params
     */
    @Override
    @ColAssign
    public List<PcbstatementVO> getPcbstatement(PcbstatementVO params) 
        return engineeringMapper.selectPcbstatement(params);
    

    /**
     * 使用示例：在bean的属性上增加@Assign，其中roleCallout的值为角色代码，用逗号分割标识多个角色
     *
     * @param params
     */
    @Excel(name = "工程及其它费用",cellType = Excel.ColumnType.NUMERIC)
    @Assign(roleCallout = "admin,confidential")
    private Double amount;

excel导出增强支持冻结首行以及开启筛选列<均为可选项>

    @Log(title = "客户组别管理", businessType = BusinessType.EXPORT)
    @RequiresPermissions("auxiliary:customergroup:export")
    @PostMapping("/customergroup/export")
    public void export(HttpServletResponse response, Data9977 data9977)
    
        List<Data9977> list = iErpSalesmoduleservice.getCustomerGroupList(data9977);
        ExcelUtil<Data9977> util = new ExcelUtil<Data9977>(Data9977.class);
        /**
         第四个参数是否冻结首行
         第五个参数是否筛选列
         */
        util.exportExcel(response, list, "客户组别信息",true,true);

积木报表

工作流引擎

分布式锁

Redisson是Redis官方推荐的Java版的Redis客户端,此处我们只用它的分布式锁功能。

package com.jovefast.common.redis.redisson;

import org.redisson.api.RLock;
import org.redisson.api.RedissonClient;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import java.util.concurrent.TimeUnit;

/**
* redis锁工具类
*
* @author Acechengui
  */
  @Component
  public class RedisLock
  
  @Autowired
  private RedissonClient redissonClient;

  /**
    * 获取锁
    *
    * @param lockKey 锁实例key
    * @return 锁信息
      */
      public RLock getRLock(String lockKey)
      
      return redissonClient.getLock(lockKey);
      

  /**
    * 加锁
    *
    * @param lockKey 锁实例key
    * @return 锁信息
      */
      public RLock lock(String lockKey)
      
      RLock lock = getRLock(lockKey);
      lock.lock();
      return lock;
      

  /**
    * 加锁
    *
    * @param lockKey 锁实例key
    * @param leaseTime 上锁后自动释放锁时间
    * @return true=成功；false=失败
      */
      public Boolean tryLock(String lockKey, long leaseTime)
      
      return tryLock(lockKey, 0, leaseTime, TimeUnit.SECONDS);
      

  /**
    * 加锁
    *
    * @param lockKey 锁实例key
    * @param leaseTime 上锁后自动释放锁时间
    * @param unit 时间颗粒度
    * @return true=加锁成功；false=加锁失败
      */
      public Boolean tryLock(String lockKey, long leaseTime, TimeUnit unit)
      
      return tryLock(lockKey, 0, leaseTime, unit);
      

  /**
    * 加锁
    *
    * @param lockKey 锁实例key
    * @param waitTime 最多等待时间
    * @param leaseTime 上锁后自动释放锁时间
    * @param unit 时间颗粒度
    * @return true=加锁成功；false=加锁失败
      */
      public Boolean tryLock(String lockKey, long waitTime, long leaseTime, TimeUnit unit)
      
      RLock rLock = getRLock(lockKey);
      boolean tryLock = false;
      try
      
      tryLock = rLock.tryLock(waitTime, leaseTime, unit);
      
      catch (InterruptedException e)
      
      return false;
      
      return tryLock;
      

  /**
    * 释放锁
    *
    * @param lockKey 锁实例key
      */
      public void unlock(String lockKey)
      
      RLock lock = getRLock(lockKey);
      lock.unlock();
      

  /**
    * 释放锁
    *
    * @param lock 锁信息
      */
      public void unlock(RLock lock)
      
      lock.unlock();

用法:

@Autowired
private RedisLock redisLock;

// lockKey 锁实例key waitTime 最多等待时间 leaseTime 上锁后自动释放锁时间  unit 时间颗粒度
redisLock.lock(lockKey);
redisLock.tryLock(lockKey, leaseTime);
redisLock.tryLock(lockKey, leaseTime, unit);
redisLock.tryLock(lockKey, waitTime, leaseTime, unit);
redisLock.unlock(lockKey);
redisLock.unlock(lock);

目录结构

com.jovefast     
├── jovefast-gateway         // 网关模块
├── jovefast-auth            // 认证中心
├── jovefast-flowable        // 工作流中心
├── jovefast-api             // 接口模块
│       └── jovefast-api-system                          // 系统接口
├── jovefast-common          // 通用模块
│       └── jovefast-common-core                         // 核心模块
│       └── jovefast-common-datascope                    // 权限范围
│       └── jovefast-common-datasource                   // 多数据源
│       └── jovefast-common-log                          // 日志记录
│       └── jovefast-common-redis                        // 缓存服务
│       └── jovefast-common-seata                        // 分布式事务
│       └── jovefast-common-security                     // 安全模块
│       └── jovefast-common-swagger                      // 系统接口
├── jovefast-modules         // 业务模块
│       └── jovefast-system                              // 系统模块 
│       └── jovefast-gen                                 // 代码生成 
│       └── jovefast-job                                 // 定时任务 
│       └── jovefast-file                                // 文件服务 
│       └── jovefast-report                                // 报表服务
├── jovefast-visual          // 图形化管理模块
│       └── jovefast-visual-monitor                      // 监控中心 
├──pom.xml                // 公共依赖

架构图

以上是关于若依框架，集成flowable工作流的主要内容，如果未能解决你的问题，请参考以下文章

37Springboot集成Flowable

若依项目分模块集成uflo2

Flowable

若依框架集成JimuReport积木报表

第二十一篇Flowable之SpringBoot集成FlowableUI

第二十二篇Flowable之SpringBoot集成FlowableUI