react 前端框架如何驱动企业数字化转型与创新发展
1556
2022-11-15
SpringBoot整合Drools规则引擎动态生成业务规则的实现
最近的项目中,使用的是flowable工作流来处理业务流程,但是在业务规则的配置中,是在代码中直接固定写死的,领导说这样不好,需要规则可以动态变化,可以通过页面去动态配置改变,所以就花了几天时间去研究了一下Drools规则引擎框架。然后应用到了项目中。
首先在项目中引入规则引擎相关依赖
这里的drools版本使用的是7.20.0.Final,如果想和Flowable结合使用,在流程画图中插入规则任务,可以将drools版本和flowable starter中管理的drools版本 一致,比如我现在的项目中用到的
flowable-srping-boot-starter的依赖版本是6.5.0,点进去这个jar包的pom文件
再进一步点parent标签
然后再点parent标签的依赖
然后再点parent标签内的flowable-root,然后搜索drools
可以看到flowable starter集成管理的drools版本是7.6.0-Final,所以最好和这个版本保持一致
当然你需要在flowable modeler画图项目中引入,然后启动flowable modeler程序,在画图界面
任务类型中就可以看到一个Business rule task,商业规则任务。
如果只是独立使用,则可以直接使用我最开始引入的那个版本7.20.0.Final
还有一个问题就是如果你的项目中引入了spring boot的热部署工具,
需要把这个依赖注释掉,项目中不能引入这个jar包,不然这个jar包会影响drools规则引擎执行生成的规则,而且在运行规则的时候也不会报错,这是个很隐蔽的坑,我在项目中已经踩过坑了,所以特别提示一下,就是这个jar包存在,规则引擎在触发执行规则的时候,是不会执行的,在日志信息中一直显示的是执行规则0条,即使你的规则文件语法没有任何错误,直接将这个依赖删除后,就可以正常执行规则了。
引入相关依赖后,需要在项目中添加配置类:
在config包下创建DroolsAutoConfiguration类
import cn.hutool.core.util.CharsetUtil;
import lombok.extern.slf4j.Slf4j;
import org.kie.api.KieBase;
import org.kie.api.KieServices;
import org.kie.api.builder.*;
import org.kie.api.runtime.KieContainer;
import org.kie.api.runtime.KieSession;
import org.kie.internal.io.ResourceFactory;
import org.kie.spring.KModuleBeanFactoryPostProcessor;
import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.io.Resource;
import org.springframework.core.io.support.PathMatchingResourcePatternResolver;
import org.springframework.core.io.support.ResourcePatternResolver;
import java.io.IOException;
/**
* @author xiaomifeng1010
* @version 1.0
* @date: 2021/12/6 9:30
* @Description drools配置类
*/
@Configuration
@Slf4j
public class DroolsAutoConfiguration {
public static final String RULE_PATH="rules/";
public KieServices getKieServices(){
KieServices kieServices = KieServices.Factory.get();
return kieServices;
}
/**
* 管理规则文件的位置路径信息
* @return
* @throws IOException
HGgrvpCOK */
@Bean
@ConditionalOnMissingBean(KieFileSystem.class)
public KieFileSystem kieFileSystem() throws IOException {
KieFileSystem kieFileSystem = getKieServices().newKieFileSystem();
for (Resource file:getRuleFiles()) {
kieFileSystem.write(ResourceFactory.newClassPathResource(RULE_PATH+file.getFilename(), CharsetUtil.UTF_8));
}
return kieFileSystem;
}
@Bean
@ConditionalOnMissingBean(KieContainer.class)
public KieContainer kieContainer() throws IOException {
KieServices kieServices = getKieServices();
KieRepository kieRepository = kieServices.getRepository();
kieRepository.addKieModule(new KieModule() {
@Override
public ReleaseId getReleaseId() {
return kieRepository.getDefaultReleaseId();
}
});
KieBuilder kieBuilder = kieServices.newKieBuilder(kieFileSystem());
kieBuilder.buildAll();
Results results = kieBuilder.getResults();
if (results.hasMessages(Message.Level.ERROR)){
log.error(results.getMessages().toString());
}
KieContainer kieContainer = kieServices.newKieContainer(kieRepository.getDefaultReleaseId());
return kieContainer;
}
@Bean
@ConditionalOnMissingBean(KieBase.class)
public KieBase kieBase() throws IOException {
KieBase kieBase = kieContainer().getKieBase();
return kieBase;
}
@Bean
@ConditionalOnMissingBean(KieSession.class)
public KieSession kieSession() throws IOException {
return kieContainer().newKieSession();
}
@Bean
@ConditionalOnMissingBean(KModuleBeanFactoryPostProcessor.class)
public KModuleBeanFactoryPostProcessor kModuleBeanFactoryPostProcessor(){
KModuleBeanFactoryPostProcessor kModuleBeanFactoryPostProcessor = new KModuleBeanFactoryPostProcessor();
return kModuleBeanFactoryPostProcessor;
}
/**
* 获取规则文件资源
* @return
* @throws IOException
*/
private Resource[] getRuleFiles() throws IOException {
ResourcePatternResolver resourcePatternResolver
=new PathMatchingResourcePatternResolver();
Resource[] resources = resourcePatternResolver.getResources("classpath*:" + RULE_PATH + "**/*.*");
return resources;
}
}
然后在项目的resources下创建rules文件夹存放规则文件
创建一个drl后缀的规则文件FixRateCostCalculatorRule.drl
//package 可以随意指定,没有具体的要求,可以命名成和项目相关的,或者直接rules
package com.drools
//或者这样
//package rules
import java.math.BigDecimal
import java.lang.Integer
import org.apache.commons.lang3.math.NumberUtils;
import com.drools.bo.GuatanteeCost
//这里设置的全局变量只相当于声明变量,需要在代码执行规则前给该变量赋值初始化
global org.slf4j.Logger logger
rule "rule1"
//dialect "java"
salience 30
//防止死循环
//no-loop true
enabled false
when
$guaranteeCost:GuatanteeCost(amount>NumberUtils.DOUBLE_ZERO && amount<=300000)
then
$guaranteeCost.setCost(200d);
logger.info("保费"+200);
update($guaranteeCost)
end
rule "rule2"
enabled false
salience 20
when
$guaranteeCost:GuatanteeCost(amount>300000,amount<=500000)
then
$guaranteeCost.setCost(300d);
logger.info("保费"+300);
update($guaranteeCost)
end
rule "rule3"
enabled false
salience 10
when
$guaranteeCost:GuatanteeCost(amount>500000,amount<=800000)
then
// 效果和上边两条范围中的更新数据效果一样
modify($guaranteeCost){
setCost(400d)
}
logger.info("保费"+400);
end
然后需要创建一个java对象GuatanteeCost,用于向规则文件中传递Fact(java对象)变量值
amount是GuatanteeCost类中的属性
@Data
@NoArgsConstructor
@AllArgsConstructor
public class GuatanteeCost {
/**
* 保证金金额
*/
private Double amount;
/**
* 保费金额
*/
private Double cost;
}
然后就可以写一个单元测试方法,或者创建一个controller进行测试
import cn.hutool.core.util.CharsetUtil;
import com.baomidou.mybatisplus.core.toolkit.Wrappers;
import com.drools.bo.GuatanteeCost;
import com.drools.entity.DroolsRuleConfig;
import com.drools.service.DroolsRuleConfigService;
import com.github.xiaoymin.knife4j.annotations.ApiSort;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiImplicitParam;
import io.swagger.annotations.ApiOperation;
import lombok.AllArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.lang3.StringUtils;
import org.drools.template.ObjectDataCompiler;
import org.kie.api.io.ResourceType;
import org.kie.api.runtime.KieSession;
import org.kie.internal.io.ResourceFactory;
import org.kie.internal.utils.KieHelper;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import java.io.IOException;
import java.io.InputStream;
import java.math.BigDecimal;
import java.util.List;
/**
* @author xiaomifeng1010
* @version 1.0
* @date: 2021/12/6 15:41
* @Description
*/
@RestController
@RequestMapping("/drools")
@AllArgsConstructor(onConstructor_={@Autowired})
@Api(tags = "drools规则引擎测试接口")
@ApiSort(30)
@Slf4j
public class DroolsTestController {
@Autowired
private KieSession kieSession;
@Autowired
private DroolsRuleConfigService droolsRuleConfigService;
@ApiOperation("测试计算保费规则")
@ApiImplicitParam(name="bzjAmount",value = "保证金金额(单位元)")
@PostMapping("test/rule")
public String testDrools(BigDecimal bzjAmount){
GuatanteeCost guatanteeCost = new GuatanteeCost();
guatanteeCost.setAmount(bzjAmount.doubleValue());
kieSession.insert(guatanteeCost);
kieSession.setGlobal("logger",log);
int allRules = kieSession.fireAllRules();
Double cost = guatanteeCost.getCost();
log.info("成功执行{}条规则",allRules);
log.info("计算保费{}元", cost);
kieSession.dispose();
return cost+"";
}
@ApiOperation("测试使用规则模板计算保费规则")
@ApiImplicitParam(name="bzjAmount",value = "保证金金额(单位元)")
@PostMapping("test/ruleTemplate")
public String testDroolsRuleTemplate(BigDecimal bzjAmount){
GuatanteeCost guatanteeCost = new GuatanteeCost();
guatanteeCost.setAmount(bzjAmount.doubleValue());
List
.eq(DroolsRuleConfig::getRuleName, "fix"));
ObjectDataCompiler converter = new ObjectDataCompiler();
String drlContent = StringUtils.EMPTY;
try(InputStream dis= ResourceFactory.
newClassPathResource("rules/FixRateCostCalculatorRule.drt", CharsetUtil.UTF_8)
.getInputStream()){
// 填充模板内容
drlContent=converter.compile(droolsRuleConfigList, dis);
log.info("生成的规则内容:{}",drlContent);
}catch (IOException e) {
log.error("获取规则模板文件出错:{}",e.getMessage());
}
KieHelper helper = new KieHelper();
helper.addContent(drlContent, ResourceType.DRL);
KieSession ks = helper.build().newKieSession();
ks.insert(guatanteeCost);
// kieSession.setGlobal("logger",log);
int allRules = ks.fireAllRules();
Double cost = guatanteeCost.getCost();
log.info("成功执行{}条规则",allRules);
log.info("计算保费{}元", cost);
kieSession.dispose();
return cost+"";
}
}
至此,可以先忽视第二个接口方法,使用第一个接口方法来测试规则的运行
计算的费用是200,执行的是rule1规则,200000介于0-300000之间,所以保费计算的是200
这种直接写drl规则文件,在里边设定规则的方式比较简便,但是却不灵活,如果我想再添加几条范围,那么就需要重新再来修改这个drl文件,所以在项目中可以使用规则模板drt
然后在项目resources的rules目录下再创建一个drt文件FixRateCostCalculatorRule.drt
//模板文件
template header
min
max
fixedFee
package drools.templates
import com.drools.bo.GuatanteeCost
template "fixRate"
rule "calculate rule_@{row.rowNumber}"
dialect "mvel"
no-loop true
when
$guaranteeCost:GuatanteeCost(amount>@{min} && amount<=@{max})
then
modify($guaranteeCost){
setCost(@{fixedFee})
}
end
end template
然后创建一个表,用于保存min,max和fixed的参数值(注意事项:template header下边的min,max和fixedFee都相当于声明的参数,但是不能在min上边加一行注释如://参数说明,在解析规则模板时候会把“//参数说明”也当做声明的参数变量),因为这些值可以动态变化了,所以范围规则也相当于可以动态变化,范围就不是之前设置的固定的啦
创建这样一个表,这样就可以灵活配置范围和保费金额了
CREATE TABLE `biz_drools_rule_config` (
`id` bigint(20) NOT NULL,
`rule_code` varchar(255) DEFAULT NULL COMMENT '规则编码',
`rule_name` varchar(255) DEFAULT NULL COMMENT '规则名称',
`min` int(10) DEFAULT NULL COMMENT '保证金范围最小值',
`max` int(10) DEFAULT NULL COMMENT '保证金范围最大值',
`fixed_fee` decimal(10,2) DEFAULT NULL COMMENT '固定保费',
`fee_rate` decimal(5,3) DEFAULT NULL COMMENT '费率(小数)',
`create_by` varchar(25) DEFAULT NULL,
`create_time` datetime DEFAULT NULL,
`update_by` varchar(25) DEFAULT NULL,
`update_time` datetime DEFAULT NULL,
PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 ROW_FORMAT=DYNAMIC;
然后创建对应的实体类,mapper和service,可以使用项目中的代码生成器快捷生成或者idea的插件生成
然后就可以使用controller中的第二个接口方法来测试了
数据库中的数据插入,可以在项目页面中写一个用于添加规则配置参数的页面,在里边插入几条数
这里我是先随意手动添加了几条数据
然后在knife4j文档页面执行接口测试
加上oauth2的验证信息
输入amount的值,也计算的固定保费200
同时从数据库中查询出来3条数据,对应三个范围,生成了三个规则(rule),可以从项目日志中查看
此时可以把数据库中的最大最小值改变一下,再测试一下
此时再传入一个保证金amount值20万,就会计算出保费费用是300元,执行代码时,会再次生成新的规则,每次执行规则模板动态生成的规则drl内容实际上保存在内存中的,并不像最开始创建的drl文件那样
再次执行,就会发现保费计算就成了300元
同时规则模板动态生成的规则内容也对应发生了变化
为了方便使用这个规则模板,可以将测试规则模板的这个接口方法封装成一个辅助类,在业务使用时,可以直接调用
package com.drools.util;
import cn.hutool.core.util.CharsetUtil;
import com.baomidou.mybatisplus.core.toolkit.Wrappers;
import com.drools.bo.GuatanteeCost;
import com.drools.entity.DroolsRuleConfig;
import com.drools.service.Drohttp://olsRuleConfigService;
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.lang3.StringUtils;
import org.drools.template.ObjectDataCompiler;
import org.kie.api.io.ResourceType;
import org.kie.api.runtime.KieSession;
import org.kie.internal.io.ResourceFactory;
import org.kie.internal.utils.KieHelper;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import java.io.IOException;
import java.io.InputStream;
import java.math.BigDecimal;
import java.util.List;
/**
* @author xiaomifeng1010
* @version 1.0
* @date: 2021/12/8 16:22
* @Description 根据规则引擎模板获取保费金额
*/
@Component
@Slf4j
public class CalculateCostUtil {
@Autowired
private DroolsRuleConfigService droolsRuleConfigService;
/**
* @description: 获取固定保费
* @author: xiaomifeng1010
* @date: 2021/12/8
* @param bzjAmount
* @return: BigDecimal
**/
public BigDecimal getFixedFee(BigDecimal bzjAmount){
GuatanteeCost guatanteeCost = new GuatanteeCost();
guatanteeCost.setAmount(bzjAmount.doubleValue());
HGgrvpCOKList
.eq(DroolsRuleConfig::getRuleName, "fix"));
ObjectDataCompiler converter = new ObjectDataCompiler();
String drlContent = StringUtils.EMPTY;
try(InputStream dis= ResourceFactory.
newClassPathResource("rules/FixRateCostCalculatorRule.drt", CharsetUtil.UTF_8)
.getInputStream()){
// 填充模板内容
drlContent=converter.compile(droolsRuleConfigList, dis);
log.info("生成的规则内容:{}",drlContent);
}catch (IOException e) {
log.error("获取规则模板文件出错:{}",e.getMessage());
}
KieHelper helper = new KieHelper();
helper.addContent(drlContent, ResourceType.DRL);
KieSession ks = helper.build().newKieSession();
ks.insert(guatanteeCost);
int allRules = ks.fireAllRules();
Double cost = guatanteeCost.getCost();
log.info("成功执行{}条规则",allRules);
log.info("计算保费{}元", cost);
ks.dispose();
return BigDecimal.valueOf(cost);
}
}
暂时就研究了这些点东西,算是刚刚入门这个框架,买的drools图书,还得再多读几遍,多实践操作一下,以后再做一些更深入的总结
版权声明:本文内容由网络用户投稿,版权归原作者所有,本站不拥有其著作权,亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容,请联系我们jiasou666@gmail.com 处理,核实后本网站将在24小时内删除侵权内容。
发表评论
暂时没有评论,来抢沙发吧~