在現(xiàn)代企業(yè)級(jí)應(yīng)用中，業(yè)務(wù)規(guī)則的靈活性至關(guān)重要。規(guī)則引擎的引入，使得系統(tǒng)可以通過(guò)動(dòng)態(tài)配置的方式管理業(yè)務(wù)邏輯，而不需要頻繁修改代碼，從而提升了系統(tǒng)的可維護(hù)性與可擴(kuò)展性。

在眾多規(guī)則引擎方案中，QLExpress 以其簡(jiǎn)潔的語(yǔ)法、高效的執(zhí)行性能以及強(qiáng)大的擴(kuò)展能力，成為一個(gè)頗具競(jìng)爭(zhēng)力的選擇。QLExpress 由阿里巴巴開(kāi)發(fā)，廣泛應(yīng)用于電商、金融等高并發(fā)場(chǎng)景，支持布爾邏輯、數(shù)學(xué)運(yùn)算、表達(dá)式解析以及動(dòng)態(tài)腳本執(zhí)行。

QLExpress 的主要特性

• 線程安全腳本運(yùn)行時(shí)的臨時(shí)變量基于 ThreadLocal 機(jī)制，保證了并發(fā)安全。
• 高效執(zhí)行支持腳本編譯緩存機(jī)制，并利用變量池優(yōu)化運(yùn)行時(shí)臨時(shí)變量的創(chuàng)建，與 Groovy 運(yùn)行效率相當(dāng)。
• 弱類型腳本語(yǔ)言語(yǔ)法風(fēng)格類似于 JavaScript 和 Groovy，提高了業(yè)務(wù)邏輯的靈活性。
• 安全機(jī)制提供防止死循環(huán)、高危 API 調(diào)用等安全控制措施。
• 輕量級(jí)核心依賴包體積僅 250KB，適用于所有 Java 運(yùn)行環(huán)境。

接下來(lái)，我們將基于 Spring Boot 3.4 介紹如何集成和使用 QLExpress。

QLExpress 實(shí)戰(zhàn)

引入依賴

在 pom.xml 文件中添加以下依賴：

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>QLExpress</artifactId>
    <version>3.3.3</version>
</dependency>

無(wú)需額外配置，即可在項(xiàng)目中直接使用 QLExpress。

基本示例

下面是一個(gè)簡(jiǎn)單的示例，展示如何使用 QLExpress 進(jìn)行數(shù)學(xué)運(yùn)算：

package com.icoderoad.qlexpress;


import com.ql.util.express.DefaultContext;
import com.ql.util.express.ExpressRunner;


public class QLExpressDemo {
    public static void main(String[] args) throws Exception {
        ExpressRunner runner = new ExpressRunner();
        DefaultContext<String, Object> context = new DefaultContext<>();


        context.put("a", 1);
        context.put("b", 2);
        context.put("c", 3);


        String express = "a + b * c";
        Object result = runner.execute(express, context, null, true, false);


        System.out.printf("%s = %s%n", express, result);
    }
}

運(yùn)行上述代碼，將輸出：

a + b * c = 7

可以看到，QLExpress 語(yǔ)法類似于 Java 的表達(dá)式計(jì)算方式，使用起來(lái)非常直觀。

語(yǔ)法規(guī)則

QLExpress 支持如下運(yùn)算符：

• 算術(shù)運(yùn)算+ - * / % mod（取模）
• 比較運(yùn)算< > <= >= == != <>
• 邏輯運(yùn)算&& || !
• 流程控制if else、for、break、continue

示例：計(jì)算 1 到 n 的累加和

String express = """
    for(i = 1; i <= n; i++) {
        sum = sum + i;
    }
    return sum;
""";

對(duì)象操作

QLExpress 允許在表達(dá)式中創(chuàng)建和操作 Java 對(duì)象：

String express = """
    import com.icoderoad.service.PersonService;
    import com.icoderoad.model.Person;
    
    ps = new PersonService();
    ps.save(new Person());
""";

自定義函數(shù)

我們可以在表達(dá)式中定義函數(shù)，提高代碼復(fù)用性：

String express = """
    function add(int a, int b) {
        return a + b;
    }
    return Math.PI + add(arg1, arg2);
""";

關(guān)鍵字別名

QLExpress 允許開(kāi)發(fā)者自定義關(guān)鍵字的別名，使表達(dá)式更加易讀。

runner.addOperatorWithAlias("如果", "if", null);
runner.addOperatorWithAlias("否則", "else", null);
runner.addOperatorWithAlias("返回", "return", null);
String express = "如果(a > b) { 返回 1; } 否則 { 返回 0; }";

綁定 Java 方法

我們可以將 Java 方法綁定到 QLExpress，方便在表達(dá)式中調(diào)用：

runner.addFunctionOfClassMethod("四舍五入", CommonService.class, "roundUp", new Class[]{double.class}, null);
String express = "四舍五入(56.54788)";
Object result = runner.execute(express, null, null, true, false);

宏定義

宏定義類似于表達(dá)式模板，可以簡(jiǎn)化復(fù)雜計(jì)算：

runner.addMacro("計(jì)算平均成績(jī)", "(語(yǔ)文 + 數(shù)學(xué) + 英語(yǔ)) / 3.0");
runner.addMacro("是否優(yōu)秀", "計(jì)算平均成績(jī) > 90");

變量查詢

QLExpress 允許我們獲取表達(dá)式中使用的變量列表，以便動(dòng)態(tài)分析：

String express = """
    int ret = (a + b + Math.PI * c ) / 4;
    return ret;
""";
String[] vars = runner.getOutVarNames(express);
for (String var : vars) {
    System.out.printf("var: %s%n", var);
}

結(jié)語(yǔ)

QLExpress 作為一款輕量級(jí)、功能強(qiáng)大的動(dòng)態(tài)腳本引擎，為 Java 開(kāi)發(fā)者提供了一種高效、靈活的方式來(lái)實(shí)現(xiàn)復(fù)雜業(yè)務(wù)邏輯。結(jié)合 Spring Boot 3.4，可以讓業(yè)務(wù)規(guī)則動(dòng)態(tài)調(diào)整，而無(wú)需修改核心代碼，極大地提高了系統(tǒng)的擴(kuò)展性。

希望本文的講解能夠幫助你更好地理解和使用 QLExpress，在項(xiàng)目中靈活運(yùn)用它的強(qiáng)大功能！