QLExpress 规则引擎使用介绍

2021年11月20日 阅读数:3
这篇文章主要向大家介绍QLExpress 规则引擎使用介绍,主要内容包括基础应用、实用技巧、原理机制等方面,希望对大家有所帮助。

一个轻量级的类java语法规则引擎,做为一个嵌入式规则引擎在业务系统中使用。让业务规则定义简便而不失灵活。让业务人员就能够定义业务规则。支持标准的JAVA语法,还能够支持自定义操做符号、操做符号重载、函数定义、宏定义、数据延迟加载等java

 

QLExpress的特性

一、编译执行:数据库

编译生成基础指令后执行,性能能获得基本保障。执行过程:单词分解-->单词类型分析-->语法分析-->生成运行期指令集合-->执行生成的指令集合express

runner.execute("10 * 10 + 1 + 2 * 3 + 5 * 2", null, true,null); 
最后生成的指令:
	1:LoadData 10
	2:LoadData 10
	3:OP : * OPNUMBER[2] 
	4:LoadData 1
	5:OP : + OPNUMBER[2] 
	6:LoadData 2
	7:LoadData 3
	8:OP : * OPNUMBER[2] 
	9:OP : + OPNUMBER[2] 
	10:LoadData 5
	11:LoadData 2
	12:OP : * OPNUMBER[2] 
	13:OP : + OPNUMBER[2]

二、支持标准的java语法、JAVA运算符号和关键字数组

import:引入一个包或者类,例如:import java.util.*;须要放在脚本的最前面
new:建立一个对象,例如:new ArrayList();
for:操做符号
if:操做符号
then:操做符号
else:操做符号
break: 终止循环
continue: 绩效循环
return: 返回
A、四则运算 : 10 * 10 + 1 + 2 * 3 + 5 * 2
     B、boolean运算: 3 > 2 and 2 > 3
     C、建立对象,对象方法调用,静态方法调用:new com.ql.util.express.test.BeanExample("张三").unionName("李四")
     D、变量赋值:a = 3 + 5
     E、支持 in,max,min:  (a in (1,2,4)) and (b in("abc","bcd","efg"))

三、自定义的关键字函数

include:在一个表达式中引入其它表达式。例如: include com.taobao.upp.b; 资源的转载能够自定义接口IExpressResourceLoader来实现,缺省是从文件中装载
[]:匿名建立数组.int[][] abc = [[11,12,13],[21,22,23]];
NewMap:建立HashMap. Map abc = NewMap(1:1,2:2);Map abc = NewMap("a":1,"b":2)
NewList:串接ArrayList.List abc = NewList(1,2,3);
exportDef: 将局部变量转换为全局变量,例如:exportDef long userId
alias:建立别名,例如: alias 用户ID user.userId
exportAlias: 建立别名,并转换为全局别名
macro: 定义宏,例如: macro 降级  {level = level - 1}
function: 定义函数,例如: function add(int a,int b){  return a+b; };
in: 操做符号,例如: 3 in (3,4,5)
mod:操做符号,例如:  7 mod 3 
like:操做符号,例如: "abc" like 'ab%'

四、自定义的系统函数,后续还会不断的添加性能

max:取最大值max(3,4,5)
   min:最最小值min(2,9,1)
   round:四舍五入round(19.08,1)
   print:输出信息不换行print("abc")
   println:输出信息并换行 println("abc")

五、提供表达式上下文,属性的值不须要在初始的时候所有加入,而是在表达式计算的时候,须要什么信息才经过上下文接口获取。ui

避免由于不知道计算的需求,而在上下文中把可能须要的数据都加入。
runner.execute("三星卖家 and 消保用户",errorList,true,expressContext) "三星卖家"和"消保用户"的属性是在须要的时候经过接口去获取。this

六、能够将计算结果直接存储到上下文中供后续业务使用。例如:url

runner.execute("c = 1000 + 2000",errorList,true,expressContext); 
  则在expressContext中会增长一个属性c=3000,也能够在expressContext实现直接的数据库操做等。

七、支持高精度浮点运算,只须要在建立执行引擎的时候指定参数便可:new ExpressRunner(true,false);
八、能够将Class和Spring对象的方法映射为表达式计算中的别名,方便其余业务人员的当即和配置。例如spa

将 Math.abs() 映射为 "取绝对值"。
      runner.addFunctionOfClassMethod("取绝对值", Math.class.getName(), "abs",new String[] { "double" }, null); 
      runner.execute("取绝对值(-5.0)",null,true,null);

九、能够为已经存在的boolean运算操做符号设置别名,增长错误信息同步输出,在计算结果为false的时候,同时返回错误信息,减小业务系统相关的处理代码

runner.addOperatorWithAlias("属于", "in", "用户$1不在容许的范围")。
   用户自定义的函数一样也能够设置错误信息:例如: 
   runner.addFunctionOfClassMethod("isOk", BeanExample?.class.getName(),"isOk", new String[] { "String" }, "$1 不是VIP用户"); 
  则在调用:
     List errorList = new ArrayList?(); 
     Object result =runner.execute("( (1+1) 属于 (4,3,5)) and isOk("玄难")",errorList,true,null); 
     执行结果 result = false.同时在errorList中还会返回2个错误缘由: 
         一、"用户 2 不在容许的范围"
         二、玄难 不是VIP用户

十、能够自定义函数,自定一个操做函数 group

class GroupOperator extends Operator {
	public GroupOperator(String aName) {
		this.name= aName;
	}
	public Object executeInner(Object[] list)throws Exception {
		Object result = new Integer(0);
		for (int i = 0; i < list.length; i++) {
			result = OperatorOfNumber.Add.execute(result, list[i]);
		}
		return result;
	}
}

则执行:

runner.addFunction("累加", new GroupOperator("累加"));
     runner.addFunction("group", new GroupOperator("group"));
    //则执行:group(2,3,4)  = 9 ,累加(1,2,3)+累加(4,5,6)=21

十一、能够自定操做符号。自定义的操做符号优先级设置为最高。例如自定一个操做函数 love:

class LoveOperator extends Operator {	
	public LoveOperator(String aName) {
		this.name= aName;
	}
	public Object executeInner(Object[] list)
			throws Exception {
		String op1 = list[0].toString();
		String op2 = list[1].toString();
		String result = op2 +"{" + op1 + "}" + op2;		
		return result;
	}
}

而后增长到运算引擎:

runner.addOperator("love", new LoveOperator("love"));
    //则执行:'a' love 'b' love 'c' love 'd' = "d{c{b{a}b}c}d"

十二、能够重载已有的操做符号。例如替换“+”的执行逻辑。参见:com.ql.util.express.test.ReplaceOperatorTest
1三、能够延迟运算须要的数据
1四、一个脚本能够调用其它脚本定义的宏和函数.参见com.ql.util.express.test.DefineTest
1五、能够相似VB的语法来使用操做符号和函数。print abc; 等价于 print(abc).参见 com.ql.util.express.test.OpCallTest
1六、支持类定义
1七、对 in 操做支持后面的是一个数组或者List变量义

 

最典型的应用场景



在业务系统中存在一些逻辑判断,例如"商品A"只能是三星卖家,并且已经开通淘宝店铺的用户才能订购。
那么咱们指望业务人员看到的配置信息就是:"三星卖家 并且 已经开店"
则经过下列步骤可能实现这个功能:

一、定义一个用户信息对象:

class UserInfo {
	long id;
	long tag;
        String name;

	public UserInfo(long aId,String aName, long aUserTag) {
		this.id = aId;
		this.tag = aUserTag;
		this.name = aName;
	}
        public String getName(){
    	   return name;
        }
	public long getUserId() {
		return id;
	}

	public long getUserTag() {
		return tag;
	}
}

二、定义两个基础的功能函数:

/**
     * 判断一个用户TAG的第X位是否为1。这个的demo,其实现合理性不考虑
     * @param user
     * @param tagBitIndex
     * @return
     */
    public boolean userTagJudge(UserInfo user,int tagBitIndex){
    	boolean r =  (user.getUserTag() & ((long)Math.pow(2, tagBitIndex))) > 0;
    	return r;
    }
	
	/**
	 * 判断一个用户是否订购过某个商品
	 * @param user
	 * @param goodsId
	 * @return
	 */
	public boolean hasOrderGoods(UserInfo user,long goodsId){
		//随机模拟一个
		if(user.getUserId() % 2 == 1){
			return true;
		}else{
			return false;
		}
	}

三、初始化语句执行器

public void initial() throws Exception{
		runner.addOperatorWithAlias("并且","and",null);
		runner.addFunctionOfClassMethod("userTagJudge", Demo.class.getName(), "userTagJudge",
                            new String[] {UserInfo.class.getName(),"int"}, "你不是三星卖家");
		runner.addFunctionOfClassMethod("hasOrderGoods", Demo.class.getName(), "hasOrderGoods",
                            new String[] {UserInfo.class.getName(),"long"}, "你没有开通淘宝店铺");
		runner.addMacro("三星卖家", "userTagJudge(userInfo,3)");//3表示三星卖家的标志位
		runner.addMacro("已经开店", "hasOrderGoods(userInfo,100)");//100表示旺铺商品的ID
	}

四、定义一个逻辑判断函数:

/**
	 * 判断逻辑执行函数
	 * @param userInfo
	 * @param expression
	 * @return
	 * @throws Exception
	 */
	public String hasPermission(UserInfo userInfo,String expression) throws Exception {			
        	IExpressContext<String,Object> expressContext = new DefaultContext<String,Object>();
    		expressContext.put("userInfo",userInfo);
    		List<String> errorInfo = new ArrayList<String>();
            Boolean result = (Boolean)runner.execute(expression, expressContext, errorInfo, true, false);
            String resultStr ="";
            if(result.booleanValue() == true){
            	resultStr = "能够订购此商品";
            }else{
              for(int i=0;i<errorInfo.size();i++){
            	  if(i > 0){
            		  resultStr  = resultStr + "," ;
            	  }
            	  resultStr  = resultStr + errorInfo.get(i);
              }
              resultStr = resultStr  + ",因此不能订购此商品";
            }
            return "亲爱的" + userInfo.getName() + " : " + resultStr;
    }

五、调用执行器执行判断逻辑:

public static void main(String args[]) throws Exception{
		Demo demo = new Demo();
		demo.initial();
		System.out.println(demo.hasPermission(new UserInfo(100,"xuannan",7),  "三星卖家   并且   已经开店"));
		System.out.println(demo.hasPermission(new UserInfo(101,"qianghui",8), "三星卖家   并且   已经开店"));
		System.out.println(demo.hasPermission(new UserInfo(100,"张三",8), "三星卖家 and 已经开店"));
		System.out.println(demo.hasPermission(new UserInfo(100,"李四",7), "三星卖家 and 已经开店"));

 

参考资料

http://code.taobao.org/p/QLExpress/wiki/index/