QLExpress：阿里巴巴开源的Java动态脚本引擎，让业务规则配置像写公式一样简单

QLExpress：阿里巴巴开源的Java动态脚本引擎，让业务规则配置像写公式一样简单

【免费下载链接】QLExpressQLExpress is a powerful, lightweight, dynamic language for the Java platform aimed at improving developers’ productivity in different business scenes.项目地址: https://gitcode.com/gh_mirrors/ql/QLExpress

QLExpress是阿里巴巴开源的一款轻量级、高性能的Java动态脚本引擎，专门为处理复杂的业务规则和数学公式混合计算场景而设计。这款强大的表达式引擎能够让你像写数学公式一样编写业务逻辑，实现灵活的业务规则动态配置，在电商、金融、风控等多个领域都有广泛应用。🚀

为什么需要QLExpress动态脚本引擎？

在现代企业应用中，业务规则经常变化：促销活动调整、价格策略更新、风控规则优化……如果每次规则变更都需要修改代码、重新部署，开发效率会大大降低。QLExpress正是为了解决这个问题而生，它允许你将业务规则从硬编码中抽离出来，实现动态配置和实时生效。

上图展示了QLExpress在电商订单风控场景中的应用：通过规则引擎对订单进行分类处理（通过/拦截/异常），并量化各规则的覆盖范围。QLExpress可以动态定义"商家黑名单"、"运营准入"等拦截规则，通过表达式计算订单是否命中规则，实现自动化风控决策。

核心功能亮点

1. 强大的表达式计算能力

QLExpress不仅支持基本的算术运算、逻辑运算，还提供了高精度计算能力。它能够智能识别数字精度问题，自动使用BigDecimal进行计算，避免Java中常见的0.1+0.2≠0.3的问题。

核心源码目录：src/main/java/com/alibaba/qlexpress4/runtime/operator/number/ 包含了各种数值运算的实现。

2. 原生JSON语法支持

QLExpress4原生支持JSON语法，可以轻松定义复杂的数据结构。JSON数组代表列表（List），JSON对象代表映射（Map），这为数据转换和映射提供了极大便利。

上图展示了QLExpress在复杂数据结构转换场景中的应用：通过表达式动态定义数据字段转换规则，实现XML到JSON结构的映射，或补充计算字段。例如，可以通过QLExpress表达式动态生成description字段，或计算quantity * unit_price得到金额。

3. 表达式计算追踪

这是QLExpress4的独特功能！在业务人员完成规则脚本配置后，很难感知线上执行情况。比如电商促销规则isVip && 未登录10天以上，到底有多少用户被vip条件拦截？又有多少用户被登录条件拦截？

QLExpress的表达式追踪功能可以获得表达式计算过程中每个中间结果的值，据此判断最终运行结果产生的原因，为规则优化和业务决策提供数据支持。

4. 多层安全策略

QLExpress提供了四种安全策略，确保脚本执行的安全性：

• 隔离策略（默认）：不允许脚本访问任何Java对象的字段和方法
• 白名单策略：只允许访问指定的字段或方法
• 黑名单策略：禁止访问特定的字段或方法
• 开放策略：允许访问所有字段和方法（仅限受信任环境）

5. 灵活的自定义能力

你可以通过Java API轻松自定义函数和操作符，快速实现业务规则的DSL（领域特定语言）。支持多种自定义方式：

• 通过Java Lambda表达式快速定义
• 继承CustomFunction类实现复杂逻辑
• 通过QLExpress脚本添加自定义函数

快速上手QLExpress

添加依赖

在你的Maven项目中添加QLExpress依赖：

<dependency> <groupId>com.alibaba</groupId> <artifactId>qlexpress4</artifactId> <version>4.1.0</version> </dependency>

第一个QLExpress程序

Express4Runner express4Runner = new Express4Runner(InitOptions.DEFAULT_OPTIONS); Map<String, Object> context = new HashMap<>(); context.put("a", 1); context.put("b", 2); context.put("c", 3); Object result = express4Runner.execute("a + b * c", context, QLOptions.DEFAULT_OPTIONS).getResult(); // result = 7

就是这么简单！几行代码就能完成复杂的表达式计算。

添加自定义函数

通过Java Lambda表达式快速定义函数：

express4Runner.addVarArgsFunction("join", params -> Arrays.stream(params).map(Object::toString).collect(Collectors.joining(","))); Object result = express4Runner.execute("join(1,2,3)", Collections.emptyMap(), QLOptions.DEFAULT_OPTIONS).getResult(); // result = "1,2,3"

实际应用场景

电商价格计算

在电商平台中，价格计算涉及多个因素：商品原价、促销折扣、会员优惠、运费等。使用QLExpress，你可以将这些因素整合到一个表达式中：

String priceRule = "原价 * (1 - 折扣率) - 优惠券金额 + 运费"; Map<String, Object> context = new HashMap<>(); context.put("原价", 100.0); context.put("折扣率", 0.2); context.put("优惠券金额", 10.0); context.put("运费", 5.0); Object finalPrice = express4Runner.execute(priceRule, context, QLOptions.DEFAULT_OPTIONS).getResult();

学生成绩评级系统

String gradeRule = """ 平均分 = (语文 + 数学 + 英语 + 综合考试.科目2) / 4.0; 如果 (平均分 > 90) 则 { return "优秀"; } 否则 如果 (平均分 > 80) 则 { return "良好"; } 否则 { return "及格"; } """;

金融风险评估

金融领域的风险评估模型通常包含复杂的数学公式和业务规则，QLExpress能够完美支持这种混合计算需求：

String riskRule = """ 风险评分 = 基础分 + (年龄 < 30 ? 10 : 0) + (收入 > 10000 ? -5 : 0) + (信用记录.逾期次数 * 2) + Math.log(负债率 + 1) * 5; 风险等级 = 风险评分 > 80 ? "高风险" : 风险评分 > 60 ? "中风险" : "低风险"; """;

高级特性

函数式编程支持

QLExpress4将函数提升为第一等公民，支持Lambda表达式和函数式编程：

String script = """ add = (a, b) -> { return a + b; }; i = add(1,2); assert(i == 3); """;

宏定义

宏是QLExpress中强大的代码复用机制，特别适用于业务规则模板：

express4Runner.addMacro("计算折扣价", "原价 * (1 - 折扣率)"); express4Runner.addMacro("计算最终价", "计算折扣价 + 运费");

动态变量

动态变量可以是一个表达式，由其他变量计算而得，支持嵌套：

DynamicVariableContext dynamicContext = new DynamicVariableContext(express4Runner, staticContext, defaultOptions); dynamicContext.put("平均成绩", "(语文+数学+英语)/3.0"); dynamicContext.put("是否优秀", "平均成绩>90");

性能优化建议

表达式缓存

对于频繁执行的表达式，开启缓存可以大幅提升性能：

// 开启缓存开关 express4Runner.execute("1+2", new HashMap<>(), QLOptions.builder().cache(true).build()); // 预编译并缓存表达式 express4Runner.parseToDefinitionWithCache("a+b");

自定义ClassLoader

在插件化架构或模块化应用中，可以通过自定义ClassLoader让QLExpress脚本访问特定ClassLoader中的类：

ClassSupplier pluginClassSupplier = clsName -> { try { return Class.forName(clsName, true, pluginClassLoader); } catch (ClassNotFoundException | NoClassDefFoundError e) { return null; } };

最佳实践

安全第一

建议采用默认的隔离策略，在脚本中不要直接调用Java对象的字段和方法。而是通过自定义函数和操作符的方式，对嵌入式脚本提供系统功能。这样能同时保证脚本的安全性和灵活性。

错误处理

QLExpress提供了友好的错误提示，无论是编译时还是运行时错误，都能精确提示错误位置：

try { express4Runner.check("a+b;\n(a+b"); } catch (QLSyntaxException e) { System.out.println("语法错误: " + e.getMessage()); System.out.println("错误行号: " + e.getLineNo()); System.out.println("错误列号: " + e.getColNo()); }

设置超时时间

给脚本设置超时时间，防止死循环或其他原因导致应用资源被过量消耗：

express4Runner.execute("while (true) { 1+1 }", Collections.emptyMap(), QLOptions.builder().timeoutMillis(100L).build());

总结

QLExpress作为阿里巴巴开源的动态脚本引擎，在业务规则与数学公式混合计算方面展现出了卓越的能力。无论是简单的四则运算，还是复杂的业务规则组合，QLExpress都能提供高效、安全的解决方案。

核心优势：

• ✅轻量级：仅250KB的jar包大小
• ✅高性能：解释执行，支持缓存优化
• ✅安全可控：多层安全策略保护
• ✅易于扩展：支持自定义函数和操作符
• ✅友好调试：表达式追踪功能
• ✅兼容性好：支持JDK 8+，与现有Java生态无缝集成

无论你是电商开发者、金融系统工程师，还是任何需要动态表达式计算的应用场景，QLExpress都能为你提供强大的支持。通过将业务规则从硬编码中解放出来，QLExpress让你的应用更加灵活、可配置，大大提升了开发效率和系统可维护性。

官方文档：docs/execute.adoc 提供了更详细的使用指南和API参考。

【免费下载链接】QLExpressQLExpress is a powerful, lightweight, dynamic language for the Java platform aimed at improving developers’ productivity in different business scenes.项目地址: https://gitcode.com/gh_mirrors/ql/QLExpress