QLExpress语法实战：从基础操作到高级扩展

1. QLExpress入门从零开始写脚本第一次接触QLExpress时我被它的轻量级设计惊艳到了。这个只有250KB的脚本引擎却能处理复杂的业务规则计算。先来看个最简单的例子ExpressRunner runner new ExpressRunner(); DefaultContextString, Object context new DefaultContext(); context.put(price, 58); context.put(quantity, 3); Object result runner.execute(price * quantity, context, null, true, false); System.out.println(result); // 输出174这种脚本特别适合处理动态定价规则。比如电商平台经常要做促销活动不同商品有不同的折扣策略。用Java硬编码会很麻烦而用QLExpress只需要修改脚本字符串就行。QLExpress的语法和Java很像但有几个关键区别需要注意变量不需要声明类型直接赋值就行数组用方括号定义比如[1,2,3]Map可以用NewMap创建比如NewMap(a:1, b:2)不支持Java 8的lambda表达式循环只能用传统for不能用增强for循环我刚开始用的时候经常犯的一个错误是尝试用Java的泛型语法。比如在QLExpress里写ListString list new ArrayList()会报错正确的写法是直接list new ArrayList()。2. 核心语法深度解析2.1 运算符的妙用QLExpress支持所有Java的基础运算符还扩展了一些实用操作符。比如和!是等价的mod和%都是取模运算in操作符可以判断元素是否在集合中like支持SQL风格的通配符匹配String script score 85; pass score 60 score 100; level score 90 ? A : (score 80 ? B : C); isVIP customerId in [1001,1002,1003]; match name like %张%;;2.2 流程控制实战QLExpress支持if-else、for、while等流程控制语句但语法略有不同// 计算1到100的和 String sumScript sum 0; for(i1;i100;i){ sum i; } return sum;; // 判断成绩等级 String gradeScript if(score 90) { return A; } else if(score 80) { return B; } else { return C; };需要注意的是QLExpress不支持try-catch异常处理也不支持switch语句。如果脚本可能出错建议在Java层捕获QLException。2.3 函数定义与调用在脚本中定义函数可以大大提高代码复用性String functionScript function calculateTax(income) { if(income 5000) return 0; return (income - 5000) * 0.2; } tax calculateTax(8000);;函数也支持多参数和递归调用。我曾经用递归实现过一个计算斐波那契数列的脚本String fibScript function fib(n) { if(n 1) return n; return fib(n-1) fib(n-2); } return fib(10);;3. 高级扩展技巧3.1 自定义操作符QLExpress允许你创建自己的操作符。比如我们实现一个连接字符串的操作符public class ConcatOperator extends Operator { public Object executeInner(Object[] list) throws Exception { return list[0].toString() list[1].toString(); } } // 注册操作符 ExpressRunner runner new ExpressRunner(); runner.addOperator(, new ConcatOperator()); Object result runner.execute(Hello World, null, null, false, false); System.out.println(result); // 输出Hello World3.2 绑定Java方法可以将Java类的方法绑定到QLExpress中直接调用public class StringUtils { public static boolean isBlank(String str) { return str null || str.trim().isEmpty(); } } // 绑定静态方法 runner.addFunctionOfClassMethod(isBlank, StringUtils.class.getName(), isBlank, new String[]{String}, null); // 绑定实例方法 ListString list new ArrayList(); runner.addFunctionOfServiceMethod(size, list, size, null, null);3.3 宏定义的应用宏定义可以简化复杂表达式的重复书写runner.addMacro(是否成年, age 18); runner.addMacro(BMI, weight / (height * height)); DefaultContextString, Object context new DefaultContext(); context.put(age, 20); context.put(weight, 70); context.put(height, 1.75); Object result runner.execute(是否成年 BMI 25, context, null, false, false);4. 性能优化与安全4.1 脚本缓存机制QLExpress会自动缓存编译后的脚本但有时需要手动管理// 预编译脚本 String script a b * c; InstructionSet instructionSet runner.parseInstructionSet(script); // 执行预编译脚本 DefaultContextString, Object context new DefaultContext(); context.put(a, 1); context.put(b, 2); context.put(c, 3); Object result runner.execute(instructionSet, context, null, false, false); // 清除缓存 runner.clearExpressCache();4.2 安全防护措施QLExpress提供了多种安全控制选项// 防止死循环 runner.execute(while(true){}, null, null, true, false, 1000); // 1秒超时 // 禁止危险方法调用 QLExpressRunStrategy.setForbiddenInvokeSecurityRiskMethods(true); try { runner.execute(System.exit(0), null, null, true, false); } catch (QLException e) { System.out.println(阻止了危险操作); }4.3 与Spring集成在实际项目中我们经常需要和Spring整合public class SpringContextRunner extends ExpressRunner { private ApplicationContext applicationContext; public SpringContextRunner(ApplicationContext applicationContext) { this.applicationContext applicationContext; } Override public Object getBean(String name) { try { return applicationContext.getBean(name); } catch (Exception e) { return null; } } } // 使用示例 SpringContextRunner runner new SpringContextRunner(springContext); runner.execute(userService.getUserCount(), null, null, false, false);5. 实战案例分享5.1 电商促销规则引擎我曾经用QLExpress实现过一个灵活的促销系统String rule if (会员等级 黄金 购物金额 1000) { 折扣 0.8; } else if (商品类别 in (电子产品,家电) 购物车数量 2) { 折扣 0.9; } else if (使用优惠券 优惠券.有效期 now()) { 折扣 0.95; } else { 折扣 1.0; } 最终价格 原价 * 折扣;;5.2 金融风控模型在金融领域QLExpress可以用来实现灵活的风控规则String riskRule 风险分数 0; if (信用分 600) 风险分数 30; if (近3月逾期次数 0) 风险分数 20*近3月逾期次数; if (负债比 0.7) 风险分数 40; if (行业 in (高风险行业列表)) 风险分数 25; return 风险分数 60 ? 通过 : 拒绝;;5.3 物联网设备控制在智能硬件项目中我用QLExpress实现了设备联动规则String deviceRule if (温度传感器.温度 30 湿度传感器.湿度 80) { 空调.打开(); 空调.设置温度(26); 窗帘.关闭(); } else if (光照传感器.亮度 50 人体传感器.有人) { 灯光.打开(); 灯光.设置亮度(80); };在实际项目中QLExpress的灵活性和性能表现都很出色。特别是在需要频繁修改业务规则的场景下使用脚本引擎可以避免频繁发布应用。不过要注意控制脚本复杂度过于复杂的脚本还是建议用Java实现。