easy-rules规则引擎最佳落地实践

简介: 写作目的这是一个头部互联网公司中的一个问题。因为有很多业务产品线,作为一个新人或者团队外的人员是很难区分不同的产品线之间的区别的,因此需要给某个产品线一个描述。但是随着业务的发展,产品线下可能又根据某个字段进一步划分,那么子产品线就是父产品线 + 字段 去区分。后面根据两个字段划分…。人都麻了。因为不同的组合有不同的链路。因此针对一个产品,我们要提供针对这个产品的具体规则描述,从而减少答疑。

接下来以 餐厅、套餐、菜品进行举例。


1.png


比如你想加盟XX火锅店,你需要像区域经理申请开店。

经理说 你开一个 牛肉火锅(prouductId = 1) 自营店(type =1)。

经理让李四 开一个 羊肉火锅(prouductId = 2) 自营店(type =1)。

经理让王五 开一个 羊肉火锅(prouductId = 2) 旗舰店(type =2)。

。。。。。


那么针对不同的场景(product && type),需要走的审批流程不一样。


●牛肉火锅(prouductId = 1) 自营店(type =1)

开店规则:需要审批菜品,审批通过后套餐自动审批通过,套餐都审批通过后 餐厅自动审批通过,审批通过后即可运营。


2.png


●羊肉火锅(prouductId = 2) 自营店(type =1)

开店规则:只审批餐厅,审批通过后即可运营。


3.png


●羊肉火锅(prouductId = 2) 旗舰店(type =2)

开店规则:

只审批餐厅,审批通过后即可运营。

但是菜品也可以申请,审批通过后套餐自动审批通过,审批通过的套餐可以每天赠送100份。


4.png


那么问题来了,如果你作为审批流程客服工作人员,当一个开店的审批工单来了以后,总有人问你为什么他的工单还在审批中,你怎么办呢?最好的方式就是你告诉他你的工单是菜品、套餐、餐厅没审批通过,请找相关同学咨询。


源码下载Gitee (亲测可用,真实有效)


启动方法和工程目录如下


5.png


java规则引擎easy-rules简单使用


以上面的牛肉火锅(prouductId = 1) 自营店(type =1) 为例


正常情况下可以写代码判断


      int productId = 1;
      int type = 1;
      if(productId == 1 && type ==1){
        System.out.println("牛肉火锅自营店。请从【餐品】开始进行向上申请");
      }


如果这样的规则能通过配置的方式进行实现,那简直无敌。


下面先写一个demo版本


    Canteen canteen = new Canteen().setProductId(1).setType(1);
    // define rules 定义规则
    Rule canteenRule =
        new RuleBuilder()
            .name("牛肉火锅自营店") // 规则名称
            .description("productId = 1 && type =1 。文案:牛肉火锅自营店。请从【餐品】开始进行向上申请") // 规则描述
            .when(facts -> facts.get("productId").equals(1) && facts.get("type").equals(1)) // 规则条件
            .then(facts -> System.out.println("牛肉火锅自营店。请从【餐品】开始进行向上申请")) // 命中规则后的操作
            .build();
    // 定义规则集合
    Rules rules = new Rules();
    rules.register(canteenRule);
    // fire rules on known facts  创建执行引擎
    RulesEngine rulesEngine = new DefaultRulesEngine();
    // define facts 定义需要验证的参数
    Facts facts = new Facts();
    facts.put("productId", canteen.getProductId());
    facts.put("type", canteen.getType());
    // 进行规则校验
    rulesEngine.fire(rules, facts);


看打印结果


6.png


上面还存在以下问题


  • ●规则还是手动通过代码定义的,如果通过配置文件定义那就最好了
  • ●命中的规则后结果只能打印,我想获取规则的一些信息比如规则描述description应该怎么办


最佳落地实践


注意:部分代码没有展示,可以去仓库查看全部源码


通过配置文件定义规则 canteenRule.yml


---
name: "牛肉火锅自营店"
description: "prouductId = 1 && type = 1 "
condition: "canteen.productId==1&&canteen.type==1"
priority: 1
actions:
  - "System.out.println(1);"
---
name: "牛肉火锅旗舰店"
description: "prouductId = 1 && type = 2"
condition: "canteen.productId == 2 && canteen.type == 1"
priority: 2
actions:
  - "System.out.println(2);"


创建规则引擎工厂类RulesEngineFactory


目的:上述例子中,规则引擎不可能只为 餐厅 服务,还需要为 套餐、菜品服务。因此肯定是有不同的规则和规则引擎的。因此这里需要一个工厂。


package com.example.demo.rulesEngine.listener;
import com.example.demo.rulesEngine.common.RuleCommonInterface;
import lombok.Data;
import org.jeasy.rules.api.Facts;
import org.jeasy.rules.api.Rules;
import org.jeasy.rules.core.DefaultRulesEngine;
import org.jeasy.rules.mvel.MVELRuleFactory;
import org.jeasy.rules.support.YamlRuleDefinitionReader;
import java.io.FileReader;
/**
 * @author chaird
 * @create 2022-11-26 13:02
 */
public class RulesEngineFactory {
  /**
   * 构建食堂规则。特殊
   *
   * @return
   */
  public static BizRuleEngine buildRuleEngine4Canteen() {
    String entityType = "canteen";
    String reulePath =
        "D:\\work\\IntelliJ IDEA 2018.2.4Workspace\\Demooo\\springboot-easu-rules-demo\\src\\main\\resources\\canteenRule.yml";
    return buildRuleEngine(entityType, reulePath);
  }
  // 可以有N个
  public static BizRuleEngine buildRuleEngine4MealGroup() {
    String entityType = "mealGroup";
    String reulePath = "xxxxx";
    // return buildRuleEngine(entityType, reulePath);
    return null;
  }
  private static BizRuleEngine buildRuleEngine(String entityType, String rulePath) {
    BizRuleEngine bizRuleEngine = new BizRuleEngine(entityType, rulePath);
    return bizRuleEngine;
  }
  @Data
  public static class BizRuleEngine {
    private String entityType;
    private MVELRuleFactory ruleFactory;
    private DefaultRulesEngine rulesEngine;
    private Rules rules;
    public BizRuleEngine(String entityType, String rulePath) {
      try {
        this.entityType = entityType;
        ruleFactory = new MVELRuleFactory(new YamlRuleDefinitionReader());
        rules = ruleFactory.createRules(new FileReader(rulePath));
        rulesEngine = new DefaultRulesEngine();
        rulesEngine.registerRuleListener(new YmlRulesListener(entityType));
      } catch (Exception e) {
        e.printStackTrace();
      }
    }
    public void fire(RuleCommonInterface input) {
      Facts facts = new Facts();
      facts.put(entityType, input);
      rulesEngine.fire(rules, facts);
    }
  }
}


这样我就可以针对餐厅这样一个特殊的实例创建自己独有的规则引擎


RulesEngineFactory.BizRuleEngine canteenRuleEngine = RulesEngineFactory.buildRuleEngine4Canteen();
Canteen canteen = new Canteen().setName("西餐厅").setProductId(1).setType(1);
//todo


创建监听器YmlRulesListener


目的:其实有有的时候命中规则后我们要做一些事情,比如取到规则的一些描述等信息好组织文案


package com.example.demo.rulesEngine.listener;
import com.example.demo.rulesEngine.common.RuleCommonInterface;
import org.jeasy.rules.api.Facts;
import org.jeasy.rules.api.Rule;
import org.jeasy.rules.api.RuleListener;
/**
 * @author chaird
 * @create 2022-11-26 1:54
 */
public class YmlRulesListener implements RuleListener {
  private String entityType ;
  @Override
  public boolean beforeEvaluate(Rule rule, Facts facts) {
    return true;
  }
  @Override
  public void afterEvaluate(Rule rule, Facts facts, boolean evaluationResult) {
  }
  @Override
  public void beforeExecute(Rule rule, Facts facts) {
  }
  @Override
  public void onSuccess(Rule rule, Facts facts) {
    //获取需要验证的对象,比如 【餐厅、套餐、菜品 implement RuleCommonInterface】
    RuleCommonInterface ruleCommon = facts.get(entityType);
    //把规则信息进行一个赋值
    ruleCommon.setDescription(rule.getDescription());
  }
  @Override
  public void onFailure(Rule rule, Facts facts, Exception exception) {
  }
  public YmlRulesListener(){
  }
  public YmlRulesListener(String entityType) {
    this.entityType = entityType;
  }
}


可以直接通过规则action进行赋值


有的时候会有转换操作,针对本文提出的案例。我想让productId =2的时候和productId = 9527的后续流程一样,可以在actions中使用下面的命令


name: "牛肉火锅旗舰店"
description: "prouductId = 1 && type = 2"
condition: "canteen.productId == 2 && canteen.type == 1"
priority: 2
actions:
  - "canteen.productId = 9527;"


总结


●这样的一个工具案例其实写文章还挺难组织思路的,代码贴的多显示不出核心思路。代码贴的少大家又看不太懂。

●百度了一些文章,其实有些都没有跑通,所以自己写一篇文章。

●其实单场景下对一个实体类进行规则校验那很简单,本文通过工厂模式设计的是对多实体类进行规则校验。总体还是有难度的。

目录
相关文章
|
5月前
|
人工智能 数据可视化 API
Multi-Agent实践第9期: 多智能体的升级体验
AgentScope 的新版本主要从 RAG,可视化和系统提示优化三个角度进行了更新,旨在降低开发者的开发代价,提供更加友好的开发体验。
|
5月前
|
Python
Mandelbrot集的最新变化形态一览——MandelBox,Mandelbulb,Burning Ship,NebulaBrot
该文介绍了几种基于Mandelbrot集的衍生形态,包括Mandelbulb、MandelBox、Burning Ship和NebulaBrot。Mandelbulb是3D扩展,使用球坐标;MandelBox利用盒映射创造复杂形状;Burning Ship以复数模和实部迭代;NebulaBrot则结合多种分形特征。文中提供了简单的Python代码示例来生成这些图形,并提到了相关学习资源。
|
6月前
|
Web App开发 JavaScript Cloud Native
构建高效可扩展的RESTful API:Node.js与Express框架实践指南构建未来:云原生架构在企业数字化转型中的关键作用
【5月更文挑战第29天】 在数字化时代的驱动下,后端服务架构的稳定性与效率成为企业竞争力的关键。本文深入探讨了如何利用Node.js结合Express框架构建一个高效且可扩展的RESTful API。我们将从设计理念、核心模块、中间件应用以及性能优化等方面进行系统性阐述。通过实例引导读者理解RESTful接口设计的最佳实践,并展示如何应对大规模并发请求的挑战,确保系统的高可用性与安全性。
|
6月前
|
小程序 API 决策智能
Multi-Agent实践第1期:5分钟上手AgentScope
阿里云与魔搭社区联合举办Create@AI创客松,邀请开发者探索基于多智能体的人机协作模式。活动提供资源支持和专家指导,获胜者可获得近5万元现金奖励及6亿次千问调用额度。参赛者需准备大模型API,如DashScope或OpenAI,使用AgentScope开源框架开发多智能体应用。立即报名参加:[报名链接](https//startup.aliyun.com/special/aihackathon4)。
|
6月前
|
人工智能 决策智能
【AI Agent系列】【阿里AgentScope框架】4. 深入源码:Pipeline模块如何组织多智能体间的数据流?- 循环结构
【AI Agent系列】【阿里AgentScope框架】4. 深入源码:Pipeline模块如何组织多智能体间的数据流?- 循环结构
187 0
|
JavaScript 前端开发 Oracle
ES6:基础使用,积累
ES6:基础使用,积累
51 0
|
弹性计算 监控 NoSQL
图数据库系统重构之路:从OrientDB迁移到NebulaGraph 真实案例分享
图数据库系统重构之路:从OrientDB迁移到NebulaGraph 真实案例分享
187 0
|
JSON 分布式数据库 数据格式
ES 10000条限制解决方案
ES 10000条限制解决方案
886 0
jira学习案例13-项目改造为ts1
jira学习案例13-项目改造为ts1
68 0
jira学习案例13-项目改造为ts1
jira学习案例14-项目改造为ts2
jira学习案例14-项目改造为ts2
67 0
jira学习案例14-项目改造为ts2