QLExpress入门及实战总结

文章目录

• • 1.背景
  • 2.简介
  • 3.QLExpress实战
  • • 3.1 基础例子
    • 3.2 低代码实战
    • • 3.2.1 需求描述
      • 3.2.1 使用规则引擎
      • 3.3.2 运行结果
      • 参考文档

        1.背景

        最近研究低代码实现后端业务逻辑相关功能，使用LiteFlow作为流程编排后端service服务, 但是LiteFlow官方未提供图形界面编排流程。且LiteFlow语法对于，通过使用json来定义流程的可视化也不够友好(二开麻烦)。因此尝试使用LiteFlow底层使用的是QLExpress，来实现可视化逻辑编排。本文记录研究过程及其一些功能总结。

        2.简介

        什么是QLExpress脚本引擎？

        QLExpress（Quick Language Express）是阿里巴巴开源的一门动态脚本引擎解析工具，起源于阿里巴巴的电商业务，旨在解决业务规则、表达式、数学计算等动态脚本的解析问题。

        3.QLExpress实战

        maven依赖配置

                                    com.alibaba            QLExpress            3.2.0        

        3.1 基础例子

        ExpressRunner runner = new ExpressRunner();DefaultContext context = new DefaultContext();context.put("a", 1);context.put("b", 2);context.put("c", 3);String express = "a + b * c";Object r = runner.execute(express, context, null, true, false);System.out.println(r);

        3.2 低代码实战

        模拟低代码中动态if功能

        3.2.1 需求描述

        要实现不硬编码，动态执行包含if的程序逻辑。必须使用声明式可复用数据结构，如下json定义

        {"rule": {        "condition": "age > 18",        "actions": {            "allow": "accessGranted",            "deny": "accessDenied"        }    },             "parameters": {        "age": 20    }}

        • rule: 规则定义部分, 包含条件节点和执行节点
        • parameters: 定义参数部分,定义参数名称及默认值

          执行过程:

          1. 低代码引擎解析规则部分，转化未低成脚本语言
          2. 读取从入参中读取流程变量配置，设置上下文
          3. 执行运算并获取结果

          下面使用springboot项目具体实现

          3.2.1 使用规则引擎

          @Servicepublic class QLExpressTestService {        public Map testIf(Map rule, Map parameters) throws Exception {        // 根据 Map 对象动态生成 QLExpress 表达式        String condition = (String) rule.get("condition");        Map actionsMap = (Map) rule.get("actions");        String allowAction = actionsMap.get("allow");        String denyAction = actionsMap.get("deny");        // 定义 allowAccess 和 denyAccess 方法        String qlExpress = "function accessGranted() { return \"Access granted\"; }" +                "function accessDenied() { return \"Access denied\"; }" +                "if (" + condition + ") { result = " + allowAction + "; } else { result = " + denyAction + "; }";        // 执行 QLExpress 表达式        ExpressRunner runner = new ExpressRunner();        DefaultContext context = new DefaultContext();        context.put("age", parameters.getOrDefault("age", 20)); // 设置年龄为20岁        Object result = runner.execute(qlExpress, context, null, true, false);        System.out.println("Result: " + result);        return Map.of("scriptContext", qlExpress, "result", result);    }}

          3.3.2 运行结果

          参考文档

          1. https://github.com/alibaba/QLExpress （官网）
          2. QLExpress学习使用总结-CSDN博客