由阿里的电商业务规则、表达式(布尔组合)、特殊数学公式计算(高精度)、语法分析、脚本二次定制等强需求而设计的一门动态脚本引擎解析工具。 在阿里集团有很强的影响力,同时为了自身不断优化、发扬开源贡献精神,于2012年开源。 先后出现了1.0版本和2.0版本,到3.0版本之后,引入了比较系统的语法树推导,使语法的功能大大增强和稳定。 之前svn的开源地址: https://code.taobao.org/p/QLExpress/src/branches/
引入了不兼容的修改, 将比较(==, >, >=, <. <=)由弱类型改成了强类型,比如在 3.2.2 中 1=="1" 为 true, 但是 3.2.3 及以后版本都是 false,升级时需要注意
去除 log4j 和 apache common log 的依赖, 原先部分 execute 参数中含有 common log ,所以部分 execute 签名有不兼容变更
BigDecimal.divide()函数增加默认的策略BigDecimal.ROUND_HALF_UP,防止在高精度要求的除法计算时,某些情况下出现以下异常。 ava.lang.ArithmeticException: Non-terminating decimal expansion
增加ExpressRunner.getInstructionSetFromLocalCache()方法。支持阿里的某个业务系统,支持直接获取本地指令集缓存,作为业务的判断场景需求。
(1)增加指令集错误日志打印输出的控制。支付宝解析外部脚本文件,文件信息有可能出现错误,处理的时候打印log日志导致应用压力太大。 (2)修复线上bug,该业务方不恰当的使用addFunctionMethod(class.name,methodName....)导致脚本运行期间每次去new Object(),效率变慢,影响了qps,换用了addServiceMethod(bean,methodName)之后得到解决。 对classname-object做了一层缓存保护,保证即使误用也能够获取到较好地性能。
(1)修复多线程下的重大bug,token使用的分隔符号数组在多线程解析脚本的情况下,有可能出现数组排序异常,导致数组中的元素混乱。 重新问题的单元用例:
https://gitlab.alibaba-inc.com/alibaba-rule-platform/qlExpress2
com.ql.util.express.bugfix.CrashTest
根本解决方案:在ExpressRunner创建的时候,就排序完毕,之后不再排序,保证多线程安全,同时也提升了编译器的性能和效率。 临时解决方案:在脚本中,需要分割的地方加一些不可见字符,比如空格等。
比如:"单价*数量+运费" 修改成 "单价 * 数量 + 运费" 就会不受这个bug影响
目前要求所有核心系统版本升级到3.0.9及以上版本。
<dependency>
<groupId>com.taobao.util</groupId>
<artifactId>taobao-express</artifactId>
<version>3.0.9</version>
</dependency>
(1)解决了指令中引用ExpressRunner的问题,使用分离的ExpressRunner来解决指令集运行期间相互的影响。
(1)分支迁移到git上,字符集修改为utf-8
(1)玄难通过jprofile进行性能分析,对数组的创建、数据获取采用了swapArray方式,大量的较少了Array的创建。 (2)补上遗漏的反射缓存。 (3)对部分对象做缓存,进一步提升性能。 (4)解决null关键字导出变量列表的时候的bug (5)注意:取消了ExpressRunner.java的以下接口,主要用在自己管理指令缓存,这个可以通过clearExpressCache()实现,所以不推荐使用,万一还是想使用这个接口,请升级到3.0.17版本。 public Object execute(InstructionSet[] instructionSets,IExpressContext<String,Object> context, List errorList, boolean isTrace,boolean isCatchException, Log aLog)
(1)支持java不定参数的调用 (2)提高数组定义的灵活性和准确性。
(1)支持Method导出,用于给菜鸟业务动态绑定函数使用
(1)支持在脚本中给任意的Object增加字段field或者方法method,比如增加string的方法,"helloworld".isNotBlank()或者"helloworld".长度 非常安全,只在脚本中生效,没有采用任何aop或者增强字节码的技术,不会影响外部的调用。
(1)考虑到老系统二方包的兼容,恢复了兼容接口ExpressRunner.execute(InstructionSet[] instructionSets....)但是不推荐使用。 (2)bugfix 3.0.16版本特性的表达式,最后不return情况下的bug。
(1)来自开源用户的反馈,bugfix 使用addFunctionOfServiceMethod指令集无法序列化的问题。
(1)增加 | & ~ << >>位操作符 (2)增加executeRule函数,打印出规则逻辑结构
(1)增加指令集的行数,出错的时候增加出错行数信息
(1)内部版本调整,避免其他的分支干扰,覆盖版本3.1.2版本
(1)增加instanceof 的操作符
(1)负号某些特殊情况下的解析bug:三元操作符,return
(1)bugfix 嵌套runner调用的时候,数据池的还原
(1)bugfix 在自定义操作符的情况下,调用 runner.getOutVarNames Api 可能引发的空指针问题
(1)增加扩展功能:ExpressRunner#setIgnoreConstChar(Boolean),设置可以忽略单字符操作,即 'a'自动变成"a"。
(1)增加扩展功能:ExpressRunner#setIgnoreConstChar(Boolean),设置可以忽略单字符操作,即 'a'自动变成"a"。
(2)增加接口来支持绑定自定义classloader的class的method:ExpressRunner#addFunctionOfClassMethod(String name, Class<?> aClass,...)。
(1)android环境的重大优化:减少编译的内存消耗,堆栈溢出问题
(2)空指针的保护策略:com.ql.util.express.config.QLExpressRunStrategy.setAvoidNullPointer(true)
(1)增加超时方法:TimeOutExceptionTest
(2)安全审核方法:InvokeSecurityRiskMethodsTest
(3)区分异常类型:ThrowExceptionTest
(4)引入了不兼容的修改, 将比较(==, >, >=, <. <=)由弱类型改成了强类型,比如在 3.2.2 中 1=="1"
为 true, 但是 3.3.3 及以后版本都是 false,升级时需要注意
(1)增加null的数字比较方案"1>null"":NullCompareTest
(1)支持强大的数组符号访问属性功能(List,Map,Array):ArrayPropertyMixTest (2)支持lambda表达式,stream方式操作集合书写更高效(List,Map):LambdaTest (3)解决数组类型的方法匹配bug:ArrayMisType
(1)彻底解决ExpressRunner重入问题,可以嵌套使用:RecursivelyRunnerTest (2)重磅特性:通过@QLAlias对字段和方法上添加注解,实现中文字段和中文方法调用:QLAliasTest
(1)QLAliasTest 添加set方法
(1)高精度计算下的溢出问题修复 com.ql.util.express.test.NumberOperatorCalculatorTest
(2)多级别安全控制与沙箱模式 com.ql.util.express.example.MultiLevelSecurityTest
(1) #188 break/continue 问题修复
(2)内置脚本 cache 改成 concurrentHashMap
(3)去除 log4j 和 apache common log 的依赖, 原先部分 execute
参数中含有 common log ,所以部分 execute
签名有不兼容变更。可能会导致升级后编译不通过
(4)#233 相关安全增强
a. 扩充默认黑名单
b. 支持通过 com.ql.util.express.config.QLExpressRunStrategy#setMaxArrLength 限制脚本一次最多申请数组的大小