QLExpress - java表达式计算


Apache
跨平台
Java

软件简介

@author qhlhl2010@gmail.com

你想知道 a love b = ? 吗 ,你想随意定义自己的操作符号吗 ? 请使用 QLExpress工具包

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

这个表达式相对别的计算工具,优点主要体现在:
A、不需要预先加载可能需要的所有属性值
B、 用户可以根据业务需要自定义操作符号和函数
C、可以同步输出判断错误信息,有利于提高业务系统在规则判断等使用场景下的用户体验。减少业务系统相关的处理代码。

主要用途:一些业务规则的组合判断,同时需要输出相关的错误信息

执行的流程:
1、单词分解
2、语法分析

最简单Hello范例:

String express = “10 * 10 + 1 + 2 * 3 + 5 * 2”;
ExpressRunner runner = new ExpressRunner();
Object result = runner.execute(express, null, false, null);
System.out.println(“表达式计算:” + express + ” = ” + result);

其它范例:
ExpressRunner runner = new ExpressRunner();
runner.addOperator(“love”, new LoveOperator(“love”));
runner.addOperatorWithAlias(“属于”, “in”, “用户$1不在允许的范围”);
runner.addOperatorWithAlias(“myand”, “and”, “用户$1不在允许的范围”);
runner.addFunction(“累加”, new GroupOperator(“累加”));
runner.addFunction(“group”, new GroupOperator(“group”));
runner.addFunctionOfClassMethod(“isVIP”, BeanExample.class.getName(),
“isVIP”, new String[] { “String” }, “$1不是VIP用户”);
runner.addFunctionOfClassMethod(“取绝对值”, Math.class.getName(), “abs”,
new String[] { “double” }, null);
runner.addFunctionOfClassMethod(“转换为大写”, BeanExample.class.getName(),
“upper”, new String[] { “String” }, null);

在这个计算引擎里面, 执行下述表达式结果:
Example 0 : System.out.println(“ss”) = null
Example 1 : unionName = new
com.ql.util.express.test.BeanExample(“张三”).unionName(“李四”) = 张三-李四
Example 2 : group(2,3,4) = 9
Example 3 : 取绝对值(-5.0) = 5.0
Example 4 : max(2,3,4,10) = 10
Example 5 : max(3,2) + 转换为大写(“abc”) = 3ABC
Example 6 : c = 1000 + 2000 = 3000
Example 7 : b = 累加(1,2,3)+累加(4,5,6) = 21
Example 8 : 三星卖家 and 消保用户 = true
Example 9 : ‘a’ love ‘b’ love ‘c’ love ‘d’ = d{c{b{a}b}c}d
Example 10 : 10 * 10 + 1 + 2 * 3 + 5 * 2 = 117
Example 11 : ( (1+1) 属于 (4,3,5)) and isVIP(“玄难”) = false
系统输出的错误提示信息:[用户 2 不在允许的范围, 玄难 不是VIP用户]

表达式支持概述:
1、基本的java语法:
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
F、支持 in,max,min: (a in (1,2,4)) and (b in(“abc”,”bcd”,”efg”))
2、提供表达式上下文,属性的值不需要在初始的时候全部加入,
而是在表达式计算的时候,需要什么信息才通过上下文接口获取
避免因为不知道计算的需求,而在上下文中把可能需要的数据都加入。
runner.execute(“三星卖家 and 消保用户”,errorList,true,expressContext)
“三星卖家”和”消保用户”的属性是在需要的时候通过接口去获取。
3、可以将计算结果直接存储到上下文中供后续业务使用。例如:
runner.execute(“c = 1000 + 2000”,errorList,true,expressContext);
则在expressContext中会增加一个属性c=3000,也可以在expressContext实现直接的数据库操作等。
4、 可以将类和Spring对象的方法映射为表达式计算中的别名,方便其他业务人员的立即和配置。例如:
将 Math.abs() 映射为 “取绝对值”。 则 “取绝对值(-5.0)” = “5.0”
runner.addFunctionOfClassMethod(“取绝对值”, Math.class.getName(), “abs”,new
String[] { “double” }, null);
5、可以为已经存在的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用户
这在业务系统需要进行规则计算,同时需要返回

6、可以自定义计算函数。例如:
自定一个操作函数 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
7、可以自定义新的操作符号 。自定义的操作符号优先级设置为最高。例如 :
自定一个操作函数 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”
8、运算引擎在没有预编译的情况下, 执行10万次 “10 * 10 + 1 + 2 * 3 + 5 * 2” 耗时:3.187秒
runner.execute(“10 * 10 + 1 + 2 * 3 + 5 * 2”, null, false,null);
在打开 预编译缓存开关的情况下, 执行10万次 “10 * 10 + 1 + 2 * 3 + 5 * 2” 耗时: 0.171秒
runner.execute(“10 * 10 + 1 + 2 * 3 + 5 * 2”, null, true,null);
运行引擎是线程安全的。在业务系统中实际使用过程中应该打开缓存预编译的开关,性能会更加。
可以调用clearExpressCache()清除缓存 。
在开启开关的情况下,会缓存解析后的最后执行指令如下所示,
避免了字符串解析、词法分析、语法分析等步骤,简单对比一下,会提高30倍的速度:
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]
9、这个表达式相对别的计算工具,有点主要体现在:
A、不需要预先加载可能需要的所有属性值
B、 用户可以根据业务需要自定义操作符号和函数
C、可以同步输出判断错误信息,有利于提高业务系统在规则判断等使用场景下的用户体验。减少业务系统相关的处理代码。
10、后续可以进一步优化的地方:
A、现有的单词拆解、词法分析、语法分析都是自己写的山寨版,可以利用其他成熟的开源工具。
B、优化具体的操作指令,提高单个操作符号的运行效率
C、经过简单的扩展支持自定义代码片段的运行。