阿里开源规则引擎QLExpress-入门实战

介绍

规则引擎，顾名思义是针对我们业务系统中普世的规则进行统一管理，通过该引擎进行调度计算，可以动态调整规则的表达式内容，而不影响业务系统代码，常见的业务典型场景有电商中促销活动，单品折扣、整场活动满减或满折

规则引擎

常用的规则引擎目前主要有Drools、Aviator、Easyrule、QLExpress,如下表格是对这些规则引擎的分析对比：

结合本人实际项目，我们的项目业务属性是电商，对性能要求比较高，因此发现阿里开源的QLExpress更适合现实的诉求，下面的章节将以电商促销活动的例子介绍QLExpress如何落地实操到业务代码中的

电商促销活动示例

比如我们的购物车现在有两个商品，对应的商品SKU分别为11120781和11120782，商品11120781参与的单品促销优惠活动，11120782参与的是单品促销打折活动，假设这两个商品来自同一个店家，店家给的运费优惠是满100减50关于两个活动规则的介绍如下：

单品促销优惠
该活动是在商品价格基础上优惠xxx元，比如商品原价为150，促销优惠50元，则优惠后的金额为150-50=100

单品促销打折
该活动是在商品价格基础上进行折扣，比如商品原价为150，促销打折5折，则优惠后的金额为150*0.5=75

第一步 引入依赖包

如下图所示，引入QLExpress的包

<dependency><groupId>com.alibaba</groupId><artifactId>QLExpress</artifactId><version>3.2.0</version></dependency>

编写针对某一类活动规则的业务接口

此接口主要处理同一类型规则的逻辑，以上述的单品促销为例，代码示例如下：

/**
     * 查询商品促销活动匹配单品促销规则计算后的优惠金额
     *
     * @param promotionList 参与的促销活动
     * @param productPrice 商品价格
     * @return
     */privateList<Double>querySinglePromotionPrice(List<Promotion> promotionList,double productPrice){List<Double> nicePrices =Lists.newArrayList();DefaultContext<String,Object> context =newDefaultContext<>();ExpressRunner expressRunner =newExpressRunner();
        promotionList = promotionList.stream().filter(r ->"singlePromotion".equals(r.getPromotionType())).collect(Collectors.toList());for(Promotion promotion : promotionList){//查询促销活动对应的规则模版配置信息RuleTemplate template =queryRuleTemplate(promotion.getPromotionType());String express = template.getExpress();
            context.put("price", productPrice);
            context.put("promotionType", promotion.getPromotionWay());
            context.put("promotionValue",Double.parseDouble(promotion.getPromotionValue()));System.out.println("参与促销活动【"+ promotion.getPromotionName()+"】优惠前的商品金额："+ productPrice);Object execute =null;try{
                execute = expressRunner.execute(express, context,null,true,true);}catch(Exception e){System.out.println("计算规则["+ template.getTemplateName()+"]时发生异常，原因："+ e.getMessage());}System.out.println("优惠后的金额："+ execute);
            nicePrices.add((Double) execute);}return nicePrices;}

涉及到的运费计算，代码示例如下：

privatedoublequeryMinShippingFree(List<Promotion> promotionList,double productPrice,double freeShipping ){DefaultContext<String,Object> context =newDefaultContext<>();double minShipping =0.0;List<Double> niceShipping =Lists.newArrayList();ExpressRunner expressRunner =newExpressRunner();
        promotionList = promotionList.stream().filter(r ->"freeShipping".equals(r.getPromotionType())).collect(Collectors.toList());for(Promotion promotion : promotionList){RuleTemplate template =queryRuleTemplate(promotion.getPromotionType());String express = template.getExpress();String condition = promotion.getConditionConfig();
            context.put("price", productPrice);
            context.put("amount",Double.parseDouble(JSONObject.parseObject(condition).getString("amountCondition")));
            context.put("shippingPrice",freeShipping);
            context.put("promotionValue",Double.parseDouble(JSONObject.parseObject(condition).getString("promotionAmount")));System.out.println("参与促销活动【"+ promotion.getPromotionName()+"】优惠前的运费："+ freeShipping);Object execute =null;try{
                execute = expressRunner.execute(express, context,null,true,true);}catch(Exception e){System.out.println("计算规则["+ template.getTemplateName()+"]时发生异常，原因："+ e.getMessage());}
            niceShipping.add((Double) execute);}if(niceShipping.isEmpty()){return minShipping;}
        minShipping =Collections.min(niceShipping);System.out.println("优惠后的运费："+ minShipping);return minShipping;}

封装以上两个方法，输出购物车中的最终优惠金额，代码示例如下：

/**
     * 计算最优促销活动价格
     *
     * @param cart  购物车信息
     * @param shippingFee  运费
     * @return 计算出最优价格
     * @throws Exception
     */@OverridepublicdoublequeryMinPromotionPrice(String cart,double shippingFee){JSONArray cartArray =JSONObject.parseArray(cart);double sum =0.0,sumNicePrice =0.0,sumNiceShipping =0.0;for(int i=0;i<cartArray.size();i++){double minNicePrice =0.0d;String productCode = cartArray.getJSONObject(i).getString("productCode");double productPrice = cartArray.getJSONObject(i).getDoubleValue("price");//查询商品参与的促销活动List<Promotion> promotionList =queryPromotion(productCode);
            sum += productPrice;//根据促销活动匹配的规则计算出优惠价格List<Double> nicePrices =querySinglePromotionPrice(promotionList, productPrice);//计算出最便宜的优惠价格
            minNicePrice =Collections.min(nicePrices);
            sumNicePrice +=minNicePrice;//运费double niceShipping =queryMinShippingFree(promotionList,productPrice,shippingFee);
            sumNiceShipping+=niceShipping;}
        sum = sum+shippingFee;System.out.println("参与促销之前购物车结算价格为："+sum);
        sumNicePrice = sumNicePrice+sumNiceShipping;System.out.println("参与促销之后购物车结算价格金额："+ sumNicePrice);return sumNicePrice;}

暴露给外部的http接口，代码示例如下：

@PostMapping("/queryMinPromotionPrice")publicdoublequeryMinPromotionPrice(String cart,double shippingFee){System.out.println("开始获取商品优惠金额");long startTime =System.currentTimeMillis();double minPrice =  expressService.queryMinPromotionPrice(cart,shippingFee);System.out.println("获取商品优惠金额结束，耗时："+(System.currentTimeMillis()-startTime)+"毫秒");return  minPrice;}

以上的这行代码 RuleTemplate template = queryRuleTemplate(promotion.getPromotionType());是代表规则表达式的模版，可以配置在数据看中，如下图所示：

以上代码，通过postman或者insomnia工具，执行结果如下图所示：

执行过程打印log信息如下图所示：