warm-flow 1.2.8版本更新,新增办理人变量表达式和条件表达式支持spel
-
【升级注意事项】
- 本次升级,内置json库snack3方式,改为spi方式加载,业务项目中存在哪种json就会使用哪种的实现, 支持顺序按顺序加载一种:snack3、jackson、fastjson、gson,并且目前只实现了这四种,可扩展
- 如在未集成snack3库的环境下,还需要使用snack3库,需要单独使用(原组件使用snack3库)
org.noear snack3 3.2.88
-
更新日志
- [feat] json库支持snack3、jackson、fastjson和gson,并且支持扩展
- [feat] 增加办理人变量表达式,支持${xxx}替换和spel,并支持扩展
- [feat] ListenerVariable监听器变量新增FlowParams字段,方便开始监听器全局传递参数
- [feat] 终止新增对开始和完成监听器的支持
- [update] springboot项目的条件表达式默认支持spel
- [update] 历史记录改为单条保存,删除重复代码
- [update] 修改FlowUserDao的bean名称
- [update] 中间节点拆分为或签,会签,票签
- [fix] 修复历史记录创建时间相等,导致流程图渲染异常
- [fix]修复Mybatis逻辑删除变成真实删除的缺陷 @xiarigang
- [refactor] 重构id生成器,支持orm默认策略,删除数据填充默认实现类,改为匿名类
部分更新内容介绍
1、增加办理人变量表达式
1.1、默认办理人变量策略
前端页面设置变量
- 比如:
@@default@@|${handler1},role:1,1
@@default@@|${handler1}
中@@default@@表示默认办理人变量策略,handler1是需要被流程变量中替换的标识role:1,1
表示办理人角色和具体办理人
后端代码设置变量
// 流程变量
Map variable = new HashMap<>();
variable.put("handler1", "100");
flowParams.variable(variable);
Instance instance = insService.skipByInsId(testLeave.getInstanceId(), flowParams);
1.2、spel办理人变量策略
前端页面设置变量
- 比如:
@@spel@@|#{@user.evalVar(#handler2)}
#{@user.evalVar(#handler2)}
是spel表达式,#handler2
是方法入参变量,可以不设置
后端代码设置变量
/**
* 用户类
*/
@Component("user")
public class User {
/**
* spel办理人变量表达式
* @param handler2 办理人
* @return String
*/
public String evalVar(String handler2) {
return handler2;
}
}
// 流程变量
Map variable = new HashMap<>();
variable.put("handler2", "101");
flowParams.variable(variable);
Instance instance = insService.skipByInsId(testLeave.getInstanceId(), flowParams);
2、监听器变量新增FlowParams字段
ListenerVariable监听器变量新增FlowParams字段,方便开始监听器全局传递参数
@Component
public class GlobalStartListener implements Listener {
private static final Logger log = LoggerFactory.getLogger(GlobalStartListener.class);
/**
* 设置办理人id、所拥有的权限等操作,也可以放到业务代码中办理前设置,或者局部监听器
* @param listenerVariable 监听器变量
*/
@Override
public void notify(ListenerVariable listenerVariable) {
log.info("全局开始监听器");
FlowParams flowParams = listenerVariable.getFlowParams();
LoginUser user = SecurityUtils.getLoginUser();
// 设置当前办理人id
flowParams.setHandler(user.getUser().getUserId().toString());
// 设置办理人所拥有的权限,比如角色、部门、用户等
List permissionList = flowParams.getPermissionFlag();
if (StringUtils.isEmpty(permissionList)) {
permissionList = new ArrayList<>();
}
List roles = user.getUser().getRoles();
if (Objects.nonNull(roles)) {
permissionList.addAll(roles.stream().map(role -> "role:" + role.getRoleId()).collect(Collectors.toList()));
}
permissionList.add("dept:" + SecurityUtils.getLoginUser().getUser().getDeptId());
permissionList.add(user.getUser().getUserId().toString());
flowParams.setPermissionFlag(permissionList);
log.info("全局开始监听器结束;{}", "开启流程完成");
}
}
3、条件表达式默认支持spel
springboot项目的条件表达式默认支持spel
- 前端配置如
#{@user.eval(#flag)}
表达式,入库前要拼接前缀,方便区分表达式类型,最终为@@spel@@|#{@user.eval(#flag)}
#flag
为变量和以下方法入参命名一致,可不设置入参
@Component("user")
public class User {
/**
* spel条件表达:判断大于等4
* @param flag 待判断的字符串
* @return boolean
*/
public boolean eval(String flag) {
BigDecimal a = new BigDecimal(flag);
BigDecimal b = new BigDecimal("4");
return a.compareTo(b) > 0;
}
}
/**
* 新增OA 请假申请
*
* @param testLeave OA 请假申请
* @return 结果
*/
@Override
public int insertTestLeave(TestLeave testLeave, String flowStatus)
{
FlowParams flowParams = FlowParams.build().flowCode(getFlowType(testLeave));
// 流程变量
Map variable = new HashMap<>();
variable.put("flag", String.valueOf(testLeave.getDay()));
flowParams.variable(variable);
Instance instance = insService.start(id, flowParams);
return instance != null? 1 : 0;
}
warm-flow介绍
[!IMPORTANT] Warm-Flow国产工作流引擎🎉,其特点简洁轻量但又不简单,五脏俱全,组件独立,可扩展,可满足中小项目的组件。
- 简洁易用:只有7张表,代码量少,可快速上手和集成
- 审批功能:支持通过、退回、任意跳转、转办、终止、会签、票签、委派和加减签、互斥和并行网关
- 监听器与流程变量:支持五种监听器,可应对不同场景,灵活可扩展,参数传递,动态权限
- 流程图:流程引擎自带流程图,可在不集成流程设计器情况下使用
- 条件表达式:内置常见的和spel条件表达式,并且支持自定义扩展
- 办理人变量表达式:内置${handler}和spel格式的表达式,可满足不同场景,灵活可扩展
- orm框架扩展:目前支持MyBatis、Mybatis-Plus、Mybatis-Flex和Jpa,后续会由社区提供其他支持,扩展方便
- 数据库支持:目前支持MySQL 、Oracle 和PostgreSQL,后续会继续支持其他数据库或者国产数据库
- 多租户与软删除:流程引擎自身维护多租户和软删除实现,也可使用对应orm框架的实现方式
- 支持角色、部门和用户等权限配置
- 同时支持spring和solon
- 兼容java8和java17,理论11也可以
- 官方提供基于ruoyi-vue封装实战项目,很实用
演示地址
- admin/admin123
演示地址:http://www.hhzai.top