QLExpress 规则引擎使用介绍

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

QLExpress的特性

1、编译执行：

编译生成基础指令后执行，性能能得到基本保障。执行过程：单词分解–>单词类型分析–>语法分析–>生成运行期指令集合–>执行生成的指令集合

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]
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”))
3、自定义的关键字

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%’
4、自定义的系统函数,后续还会不断的添加

max:取最大值max(3,4,5)
min:最最小值min(2,9,1)
round:四舍五入round(19.08,1)
print:输出信息不换行print(“abc”)
println:输出信息并换行 println(“abc”)
5、提供表达式上下文，属性的值不需要在初始的时候全部加入，而是在表达式计算的时候，需要什么信息才通过上下文接口获取。

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

6、可以将计算结果直接存储到上下文中供后续业务使用。例如：

runner.execute(“c = 1000 + 2000”,errorList,true,expressContext);
则在expressContext中会增加一个属性c=3000，也可以在expressContext实现直接的数据库操作等。
7、支持高精度浮点运算，只需要在创建执行引擎的时候指定参数即可：new ExpressRunner(true,false);
8、可以将Class和Spring对象的方法映射为表达式计算中的别名，方便其他业务人员的立即和配置。例如

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

9、可以为已经存在的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个错误原因：
1、“用户 2 不在允许的范围”
2、玄难 不是VIP用户
10、可以自定义函数,自定一个操作函数 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

11、可以自定操作符号。自定义的操作符号优先级设置为最高。例如自定一个操作函数 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”
12、可以重载已有的操作符号。例如替换“＋”的执行逻辑。参见：com.ql.util.express.test.ReplaceOperatorTest
13、可以延迟运算需要的数据
14、一个脚本可以调用其它脚本定义的宏和函数.参见com.ql.util.express.test.DefineTest
15、可以类似VB的语法来使用操作符号和函数。print abc; 等价于 print(abc).参见 com.ql.util.express.test.OpCallTest
16、支持类定义
17、对 in 操作支持后面的是一个数组或者List变量义

最典型的应用场景

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

1、定义一个用户信息对象：

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;
}

}
2、定义两个基础的功能函数：

/**
* 判断一个用户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;
	}
}

3、初始化语句执行器

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
}

4、定义一个逻辑判断函数：

/**
 * 判断逻辑执行函数
 * @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;
}	

5、调用执行器执行判断逻辑：

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 已经开店"));