基于Springboot+SpringSecurity+Activiti7实现的工作流系统可方便二次开发(附完整源码)

简介: 基于Springboot+SpringSecurity+Activiti7实现的工作流系统可方便二次开发(附完整源码)

基于Springboot+SpringSecurity+Activiti7实现的工作流系统可方便二次开发(附完整源码)

现在很多ToB的系统一般都会有工作流的相关需求,比如报价单、合同审批等等,如果是自己实现一套工作流引擎对于大多数中小企业不太实际,
并且在业务调整时也很难做到灵活的扩展,所以大家普遍会选择简单灵活易于集成的工作流引擎框架activiti。
本文就是要带大家了解在基于SpringSecurity权限框架的SpringBoot项目中怎么使用集成activiti7工作流,并且怎么把它融合到实际的单据(如请假)业务审批流程中。

Tip以下是我用SpringBoot+Activiti7实现的工作流的的源码,有兴趣可以自己获取,也欢迎大佬们提交PR一起学习

// Git代码
https://gitee.com/yeeevip/yeee-activiti7

1 功能演示

  • 在线绘制流程定义

登录admin账号,进入菜单 - 工作流 > 流程定义 > 在线制作流程;我这里是模拟一个单据审批流程,申请人提交单据后需要
进过两级审批,只要有其中一级审批不通过就会打回到申请人提交节点让重新提交审批单。

20240228-03.png

给一级审批设置审批权限,可以设置审批用户或者设置审批的部门,这样当申请人提交单据后审批任务就会流转到设置好的用户下。

20240228-04.png

  • 申请人提交审批单

进入菜单 - 工作流 > 流程定义 > (列表中找到‘刚才绘制的’这个审批流程) > 新建实例,这样就模拟了一个用户提交审批流程。

20240228-05.png

  • 一级审批进行任务审批

流程定义在不同的审批环节设置了不同部门的人员来审批,开始流程实例后,人员就可以登录自己账号进入菜单 - 工作流 > 代办任务 > 查看到自己当前的待完成审批项。
用户1可以选择 通过或者不通过,通过的话就会流转到二级审批的用户任务下,不通过就会回到申请人任务下。

20240228-06.png

2 二次开发与自己业务系统打通

2.1 通用扩展点

Activiti框架的整体架构服务按照功能领域来分的话可以分为三部分:

1 流程定义:主要负责管理流程绘制的内容视图

2 流程实例:实例就相当于在该流程定义下的审批流程,就拿请假流程来说,3个用户提交了3个审批单,相当于在这个请假留下下建了3个实例

3 审批任务:审批流程各节点的执行环节。如一个请假需要经过两个领导审批,之后流程流转过程中领导会进行各自的审批任务

所以基于以上3个领域划分后我按照功能进行了封装common-activiti7

2.1.1 流程定义通用接口

public class CommonActiviti7Service {
   
   

    // 分页获取流程定义
    public PageVO<DefinitionVo> definitionList(PageReqVO<?> reqVO) {
   
   
        PageVO<DefinitionVo> pageVO = new PageVO<>(reqVO.getPageNum(), reqVO.getPageSize());
        ...
        return pageVO;
    }

    // 删除流程定义
    public void definitionDelete(DefDeleteReq req) {
   
   
        for (String depId : req.getIds()) {
   
   
            repositoryService.deleteDeployment(depId, true);
        }
    }

    // 保存绘制好的流程定义
    public void definitionAddDeploymentByString(String stringBPMN) {
   
   
        Deployment deployment = repositoryService.createDeployment()
                .addString("CreateWithYeeeSystem.bpmn", stringBPMN)
                .deploy();
    }

    // 查看流程定义详情
    public void definitionDetailXml(HttpServletResponse response, String deploymentId, String resourceName) {
   
   
        InputStream inputStream = repositoryService.getResourceAsStream(deploymentId, resourceName);
        response.setContentType("text/xml");
        try {
   
   
            IoUtil.copy(inputStream, response.getOutputStream());
        } catch (IOException e) {
   
   
            log.error("获取失败", e);
        }
    }
}

2.1.2 流程实例通用接口

public class CommonActiviti7Service {
   
   

    // 分页获取流程实例
    public PageVO<InstanceVo> instanceList(PageReqVO<?> reqVO) {
   
   
        PageVO<InstanceVo> pageVO = new PageVO<>(reqVO.getPageNum(), reqVO.getPageSize());
        ...
        return pageVO;
    }

    // 新建流程实例
    @Transactional(rollbackFor = Exception.class, isolation = Isolation.READ_COMMITTED)
    public void instanceCreate(InstCreateReq req) {
   
   
        String authenticatedUserId = securityManager.getAuthenticatedUserId();
        Map<String,Object> variables = new HashMap<>();
        variables.put("applicant", authenticatedUserId);
        org.activiti.engine.runtime.ProcessInstance processInstance = runtimeService.startProcessInstanceById(req.getPdId(), variables);
        org.activiti.engine.task.Task task = taskService.createTaskQuery()
                .processInstanceId(processInstance.getProcessInstanceId())
                .taskUnassigned()
                .singleResult();
        taskService.claim(task.getId(), authenticatedUserId);
        taskService.complete(task.getId());
    }

    // 暂停流程实例
    public void instanceSuspend(String instanceId) {
   
   
        SuspendProcessPayload payload = ProcessPayloadBuilder
                .suspend()
                .withProcessInstanceId(instanceId)
                .build();
        processRuntime.suspend(payload);
    }
}

2.1.3 审批任务通用接口

public class CommonActiviti7Service {
   
   

    // 查询待审批任务
    public PageVO<TaskVo> taskList(PageReqVO<?> reqVO) {
   
   
        PageVO<TaskVo> pageVO = new PageVO<>(reqVO.getPageNum(), reqVO.getPageSize());
        ...
        return pageVO;
    }

    // 去完成审批任务
    public void taskComplete(TaskCompleteReq req) {
   
   
        Task task = taskRuntime.task(req.getTaskId());
        if (task == null) {
   
   
            throw new BizException("代办任务不存在");
        }
        if (task.getAssignee() == null) {
   
   
            taskRuntime.claim(TaskPayloadBuilder.claim().withTaskId(task.getId()).build());
        }
        CompleteTaskPayload payload = TaskPayloadBuilder.complete().withTaskId(task.getId())
                .withVariable("isPass", req.getIsPass())
                .build();
        taskRuntime.complete(payload);
    }
}

具体更加完整的代码请去git仓库获取:

// Git代码
https://gitee.com/yeeevip/yeee-memo/tree/master/memo-parent/memo-common/common-workflow/common-activiti7

2.2 系统的单据业务与Activiti7打通

大多数人在使用工作流框架时都不知道怎么将自己的业务与工作流框架打通,比如我们系统里有合同业务,
现在要开发合同审批的需求,那改怎么做呢?我这里说一下大致的思路:

1 绘制合同审批业务流程定义,将绘制保存好的流程定义唯一key与合同业务绑定起来(可以使用配置表关联)

2 当合同填写完成后,想要提交审批时根据配置绑定关系就可以找到对应的流程定义

3 然后通过调用流程实例api的新建实例接口,这样就开启了一个审批流程

4 这样用户就可以调用审批任务api查询所属的审批任务,之后进行审批了

3 项目使用demo

20240228-01.png

  • 新建用户角色部门权限管理系统

用户角色部门权限系统采用的是我已经封装好的javaweb通用脚手架搭建的,只需要在pom.xml中引入我脚手架以下的坐标即可:

<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">
    <!-- 通用脚手架父坐标,主要封装了一些通用模块Starter-->
    <parent>
        <groupId>vip.yeee.memo</groupId>
        <artifactId>memo-parent</artifactId>
        <version>3.2.2-SNAPSHOT</version>
        <relativePath/>
    </parent>
    ...
    <dependencies>
        <!-- 引入base-web模块就拥有了springweb的基本能力包括校验、监控等等-->
        <dependency>
            <groupId>vip.yeee.memo</groupId>
            <artifactId>base-web</artifactId>
        </dependency>
        <!-- 项目采用的安全认证框架是SpringSecurity+oauth2-->
        <!-- 这里引入的就是我封装好的Starter不需要额外开发开箱即用-->
        <dependency>
            <groupId>vip.yeee.memo</groupId>
            <artifactId>common-platform-auth-server</artifactId>
        </dependency>
        <dependency>
            <groupId>vip.yeee.memo</groupId>
            <artifactId>common-platform-auth-client</artifactId>
        </dependency>
        <!-- 由于需要数据库操作我这里使用mybatis-plus-->
        <dependency>
            <groupId>vip.yeee.memo</groupId>
            <artifactId>base-mybatis-plus</artifactId>
        </dependency>
        ...
    </dependencies>
</project>

到这里一个基于SpringSecurity+oauth2的SpringBoot用户权限系统所需的依赖基本都引入;管理界面前端的代码
我采用的是vue搭建的,具体的代码可以移步我仓库,这里不介绍了。

// 用户权限系统前端UI代码
https://gitee.com/yeeevip/yeee-activiti7/tree/activiti7-master/app-h5/yeee-admin-ui
  • 新建工作流模块引入工作流框架

为了代码结构清晰,我单独新建一个模块yeee-activiti7-manage来编写工作流相关的业务,Activiti7相关的service以及其他通用的
能力我也是都封装了一个Starter在我的JavaWeb通用脚手架里了,只需要引入对应的maven坐标到pom.xml中即可:

<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">
    <dependencies>
        <!-- 引入封装好的common-activiti7-->
        <!-- 即拥有了activiti7工作流相关的通用service-->
        <dependency>
            <groupId>vip.yeee.memo</groupId>
            <artifactId>common-activiti7</artifactId>
        </dependency>
    </dependencies>
</project>

工作流流程绘制的前端具体代码可以移步我仓库:

// 工作流流程绘制前端UI代码
https://gitee.com/yeeevip/yeee-activiti7/tree/activiti7-master/app-h5/activiti-editor
  • 将项目启动会自动生成工作流相关表

20240228-02.jpg

最后

关于Activiti7的使用我就介绍到这里了,具体有什么问题大家可以评论区留意或者私信我哦~

Tip以下是我用SpringBoot+Activiti7实现的工作流的的源码,有兴趣可以自己获取,也欢迎大佬们提交PR一起学习

// Git代码
https://gitee.com/yeeevip/yeee-activiti7
目录
相关文章
|
7天前
|
JavaScript 安全 Java
基于springboot的摄影器材租赁回收系统
本系统基于Java、Spring Boot与Vue技术,构建摄影器材租赁回收平台,解决市场不规范、资源浪费等问题。支持在线预约、信用免押、智能评估等功能,提升器材利用率,降低用户成本,推动行业绿色可持续发展。
|
4天前
|
JavaScript Java 关系型数据库
基于springboot的小区车位租售管理系统
针对城市化进程中小区停车难问题,本文设计基于SpringBoot的车位租售管理系统,结合Vue前端与MySQL数据库,实现车位信息数字化、租售流程自动化。系统支持在线查询、申请、支付及数据统计,提升管理效率与用户体验,促进资源优化配置。
|
7天前
|
JavaScript Java 关系型数据库
基于springboot的旅游门票预定系统
在数字化时代,旅游门票预定系统应运而生,结合Spring Boot、Vue、Java与MySQL技术,实现在线预订、电子验票、数据分析等功能,提升游客体验与景区管理效率,推动旅游业智能化转型。
|
7天前
|
搜索推荐 算法 JavaScript
基于springboot的健康饮食营养管理系统
本系统基于Spring Boot、Vue与MySQL技术,融合大数据与AI算法,构建个性化健康饮食管理平台。结合用户身体状况、目标需求,智能推荐营养方案,助力科学饮食与健康管理。
|
7天前
|
JavaScript 前端开发 Java
基于springboot的4s店汽车试驾销售服务系统
针对传统4S店运营效率低、服务体验差等问题,研究基于SpringBoot的汽车销售服务系统,融合Java、Vue、MySQL等技术,实现业务自动化、客户个性化服务与数据智能分析,提升管理效率与客户满意度,推动4S店数字化转型与竞争力升级。
|
4天前
|
JavaScript Java 关系型数据库
基于springboot的校内跑腿管理系统
针对校园跑腿服务效率低、信任难等问题,本研究设计基于Spring Boot与Vue的校内跑腿管理系统,融合MySQL数据库与智能化调度技术,实现任务发布、智能匹配、实时追踪与评价反馈一体化,提升服务效率与质量,助力智慧校园建设。
|
5天前
|
JavaScript Java 关系型数据库
基于springboot的快递分拣管理系统
本系统基于SpringBoot框架,结合Java、MySQL与Vue技术,构建智能化快递分拣管理平台。通过自动化识别、精准分拣与实时跟踪,提升分拣效率与准确性,降低人力成本,推动快递行业向智能化、高效化转型,助力电商物流高质量发展。
|
10天前
|
前端开发 安全 Java
基于springboot+vue开发的会议预约管理系统
一个完整的会议预约管理系统,包含前端用户界面、管理后台和后端API服务。 ### 后端 - **框架**: Spring Boot 2.7.18 - **数据库**: MySQL 5.6+ - **ORM**: MyBatis Plus 3.5.3.1 - **安全**: Spring Security + JWT - **Java版本**: Java 11 ### 前端 - **框架**: Vue 3.3.4 - **UI组件**: Element Plus 2.3.8 - **构建工具**: Vite 4.4.5 - **状态管理**: Pinia 2.1.6 - **HTTP客户端
90 4
基于springboot+vue开发的会议预约管理系统
|
4月前
|
JavaScript 前端开发 Java
制造业ERP源码,工厂ERP管理系统,前端框架:Vue,后端框架:SpringBoot
这是一套基于SpringBoot+Vue技术栈开发的ERP企业管理系统,采用Java语言与vscode工具。系统涵盖采购/销售、出入库、生产、品质管理等功能,整合客户与供应商数据,支持在线协同和业务全流程管控。同时提供主数据管理、权限控制、工作流审批、报表自定义及打印、在线报表开发和自定义表单功能,助力企业实现高效自动化管理,并通过UniAPP实现移动端支持,满足多场景应用需求。
439 1
|
5月前
|
前端开发 Java 关系型数据库
基于Java+Springboot+Vue开发的鲜花商城管理系统源码+运行
基于Java+Springboot+Vue开发的鲜花商城管理系统(前后端分离),这是一项为大学生课程设计作业而开发的项目。该系统旨在帮助大学生学习并掌握Java编程技能,同时锻炼他们的项目设计与开发能力。通过学习基于Java的鲜花商城管理系统项目,大学生可以在实践中学习和提升自己的能力,为以后的职业发展打下坚实基础。技术学习共同进步
420 7