Java中QLExpress不支持SexType.MALE原生写法，需显式传入枚举实例或注册宏；SpEL原生支持，通过T(com.example.SexType).MALE即可引用，无需手动注册。
在 Java 中，枚举类要在 QLExpress 或 SpEL 表达式引擎中被正确引用，关键在于让表达式能访问到枚举类型及其常量值。两者机制不同，需分别处理。
QLExpress 中引用枚举类
QLExpress 本身不自动识别枚举类，需显式注册或通过上下文传入枚举实例/类，常见方式有：
-
方式一：将枚举常量作为变量传入执行上下文
Map<String, Object> env = new HashMap<>(); env.put("SexType", SexType.class); // 传入类对象（用于反射调用） env.put("MALE", SexType.MALE); // 直接传入具体枚举实例 env.put("FEMALE", SexType.FEMALE); String express = "sex == MALE"; Object result = runner.execute(express, env, true, false); -
方式二：在表达式中用
Class.forName()+Enum.valueOf()动态获取（需开启enableDynamic）立即学习“Java免费学习笔记（深入）”；
// 注意：QLExpress 默认不支持静态方法链式调用，需提前注册 runner.addFunctionOfClassMethod( "valueOf", Enum.class.getName(), "valueOf", new String[]{Class.class.getName(), String.class.getName()}, null ); // 表达式写法（较绕，不推荐日常使用）： // "valueOf(SexType.class, 'MALE') == sex" -
方式三：封装为宏（Macro）或自定义函数（推荐业务场景）
runner.addMacro("是男性", "sex == MALE"); runner.addMacro("是女性", "sex == FEMALE"); // 调用时直接写：是男性 && age > 18
⚠️ 注意：QLExpress 是弱类型、运行时解析的脚本引擎，不支持 SexType.MALE 这种原生点号语法，必须提前绑定或传入。
SpEL 中引用枚举类
SpEL 原生支持枚举，方式更自然，主要有三种：
-
直接使用全限定类名 + 枚举常量（最常用）
ExpressionParser parser = new SpelExpressionParser(); EvaluationContext context = new StandardEvaluationContext(); // 表达式中直接写：T(com.example.SexType).MALE Expression expr = parser.parseExpression("T(com.example.SexType).MALE == person.sex"); Boolean result = expr.getValue(context, Boolean.class); -
在上下文中预设枚举类或常量（适合复用）
context.setVariable("MALE", SexType.MALE); context.setVariable("SexType", SexType.class); // 表达式可简化为： parser.parseExpression("sex == #MALE").getValue(context); // 或 parser.parseExpression("#SexType.MALE == sex").getValue(context); -
配合
@Value注入时引用枚举（Spring 环境下）@Value("#{T(com.example.SexType).MALE}") private SexType defaultSex; @Value("#{user.sex == T(com.example.SexType).FEMALE}") private boolean isFemale;
✅ SpEL 的 T(…) 操作符是核心——它等价于 Java 的 Class.forName(...)，能安全获取任意类（包括枚举），并访问其 static final 字段（即枚举常量）。
小结对比
| 场景 | QLExpress | SpEL |
|---|---|---|
是否支持 SexType.MALE 原生写法 |
❌ 不支持，会报找不到符号 | ✅ 支持，用 T(com.example.SexType).MALE
|
| 是否需手动注册枚举 | ✅ 推荐传入常量或注册宏 | ❌ 无需注册，T() 即可 |
是否支持枚举方法调用（如 name(), ordinal()） |
✅ 可调用，前提是枚举实例已传入上下文 | ✅ 支持，如 #person.sex.name()
|
是否支持 in 判断多个枚举值 |
✅ sex in (MALE, FEMALE)（需提前绑定） |
✅ #person.sex in {T(com.example.SexType).MALE, T(com.example.SexType).FEMALE}
|
实际开发中，若项目已用 Spring，优先选 SpEL；若需低侵入、非 Spring 环境或规则由业务人员配置，QLExpress 配合宏定义更易维护。
