warm-flow 工作流，新增监听器和参数传递

v1.1.0更新内容

• 可以跳转指定节点

• 增加全局变量

• 增加监听器

• 重构代码，解偶orm，方便扩展不同orm和数据，新增代码示例

• 修复并行网关流程流程图显示错误问题

介绍

此项目是极其简单的工作流，没有太多设计，代码量少，并且只有6张表，个把小时就可以看完整个设计。使用起来方便

1. 支持简单的流程流转，比如跳转、回退、审批
2. 支持角色、部门和用户等权限配置
3. 官方提供简单流程封装demo项目，很实用
4. 支持多租户
5. 支持代办任务和已办任务，通过权限标识过滤数据
6. 支持互斥网关，并行网关（会签、或签）
7. 可退回任意节点
8. 支持条件表达式，可扩展
9. 同时支持spring和solon
10. 兼容java8和java17,理论11也可以
11. 支持不同orm框架和数据库扩展
12. 支持增加监听器，参数传递

git地址： https://gitee.com/warm_4/warm-flow.git

demo项目：

springboot：RuoYi-Vue-Warm-Flow ｜演示地址 solon：warm-sun ｜演示地址

快速开始

在开始之前，我们假定您已经：

• 熟悉 Java 环境配置及其开发
• 熟悉 关系型 数据库，比如 MySQL
• 熟悉 Spring Boot或者Solon 及相关框架
• 熟悉 Java 构建工具，比如 Maven

表结构

https://gitee.com/warm_4/warm-flow/wikis/表结构?sort_id=9330548

maven依赖

springboot项目

      io.github.minliuhua
      warm-flow-mybatis-sb-starter
      最新版本

solon项目

      io.github.minliuhua
      warm-flow-mybatis-solon-plugin
      最新版本

支持数据库类型

• [x] mysql
• [ ] oracle
• [ ] sqlserver
• [ ] ......

支持orm框架类型

• [x] mybatis及其增强组件
• [ ] jpa
• [ ] easy-query
• [ ] wood
• [ ] sqltoy
• [ ] beetlsql
• [ ] ......

有想扩展其他orm框架和数据库的可加qq群联系群主

代码示例

https://gitee.com/min290/hh-vue/blob/master/ruoyi-admin/src/test/java/com/ruoyi/system/service/impl/FlowTest.java

部署流程

public void deployFlow() throws Exception {
        String path = "/Users/minliuhua/Desktop/mdata/file/IdeaProjects/min/hh-vue/hh-admin/src/main/resources/leaveFlow-serial.xml";
        System.out.println("已部署流程的id：" + defService.importXml(new FileInputStream(path)).getId());
    }

发布流程

public void publish() throws Exception {
        defService.publish(1212437969554771968L);
    }

开启流程

public void startFlow() {
        System.out.println("已开启的流程实例id：" + insService.start("1", getUser()).getId());
    }

流程流转

public void skipFlow() throws Exception {
        // 通过实例id流转
        Instance instance = insService.skipByInsId(1219286332141080576L, getUser().skipType(SkipType.PASS.getKey())
                .permissionFlag(Arrays.asList("role:1", "role:2")));
        System.out.println("流转后流程实例：" + instance.toString());

//        // 通过任务id流转
//        Instance instance = insService.skip(1219286332145274880L, getUser().skipType(SkipType.PASS.getKey())
//                .permissionFlag(Arrays.asList("role:1", "role:2")));
//        System.out.println("流转后流程实例：" + instance.toString());
    }

 public void skipAnyNode() throws Exception {
        // 跳转到指定节点
        Instance instance = insService.skip(1219286332145274880L, getUser().skipType(SkipType.PASS.getKey())
                .permissionFlag(Arrays.asList("role:1", "role:2")).nodeCode("4"));
        System.out.println("流转后流程实例：" + instance.toString());
    }

监听器

实现Listener接口，然后在设计器中配置好监听器

public class FinishListener implements Listener {

    @Resource
    private TestLeaveMapper testLeaveMapper;

    private static final Logger log = LoggerFactory.getLogger(StartListener.class);

    @Override
    public void notify(ListenerVariable variable) {
        log.info("完成监听器:{}", variable);
        Instance instance = variable.getInstance();
        Map<String, Object> testLeaveMap = variable.getVariable();
        TestLeave testLeave = (TestLeave) testLeaveMap.get("testLeave");
        /** 如果{@link com.ruoyi.system.service.impl.TestLeaveServiceImpl}中更新了，这里就不用更新了*/
//        testLeave.setNodeCode(instance.getNodeCode());
//        testLeave.setNodeName(instance.getNodeName());
//        testLeave.setFlowStatus(instance.getFlowStatus());
//        testLeave.setUpdateTime(DateUtils.getNowDate());
//        testLeaveMapper.updateTestLeave(testLeave);
        log.info("完成监听器结束;{}", "任务完成");
    }
}