Spring使用el表达式
0. 背景
在项目中需要一个可动态执表达式的功能.项目本身是基于Springboot,可直接使用Spring提供的核心模块Spring Expression Language(SpEL). 在测试前,需要了解一些基本前置条件
- 整体可以按照java语法编写脚本串
- 只支持单条语句执行
- 表达式串中,内部字符串可以使用单引号,双引号(需要转义)
- 表达默认导入的包为
java.lang.*,如果是其他包下的对象,需要使用包名和类名详细可以查看类StandardTypeLocator对应的构造函数
以下 1 到 10 章节为每个语法的测试代码以及执行结果.如果对测试代码和结果不敢兴趣可以快速移动到文末总结部分.对所有语法的一个简单汇总.这里只说明基本使用,下一篇会讲一些安全相关的防止RCE攻击.以及一些扩展能力
1. 调用静态方法
语法:T(class),比如T(Runtime)就是获取到类Runtime.分别需要测试测试java.lang.* 和其他包下的对象调用方式
public void testExecClassMethod() {String classMethodExpr = "T(Runtime).getRuntime().exec('calc')";ExpressionParser elParser = new SpelExpressionParser();Object value = elParser.parseExpression(classMethodExpr).getValue();System.out.println("( java.lang)执行类方法T(class): " + value);// 需要 包名+类名String otherJarMethodExpr = "T(org.apache.commons.lang.StringEscapeUtils).escapeHtml('小游戏 地心侠士')";Object thridJarValue = elParser.parseExpression(otherJarMethodExpr).getValue();System.out.println("(非java.lang)执行类方法T(class): " + thridJarValue);}
以上代码执行结果如下
( java.lang)执行类方法T(class): Process[pid=31572, exitValue="not exited"]
(非java.lang)执行类方法T(class): 小游戏 地心侠士
从执行结果可知道,动态执行脚本是很危险的操作,一部小心就被别人利用,导致RCE攻击.比如上边第一个测试代码轻松调用计算器功能.
2. 调用实例方法
语法:#root.method(args) 或者#变量名.method(args)或者直接methodName(args)
public void testInstanceMethod() {String elExpr = "substring(4,8)+' 小游戏 '+(333+333)";String elLengthExpr = "#root.length()";String testStr = "小游戏 地心侠士";System.out.println("===测试字符串===");System.out.println(testStr);ExpressionParser elParser = new SpelExpressionParser();Object strLen = elParser.parseExpression(elLengthExpr).getValue(testStr);Object value = elParser.parseExpression(elExpr).getValue(testStr);System.out.println("===使用getValue传入具体的对象==");System.out.println(elLengthExpr + ": " + strLen);System.out.println(elExpr + ":" + value);StandardEvaluationContext ctx = new StandardEvaluationContext();ctx.setRootObject(testStr);ctx.setVariable("var", testStr);value = elParser.parseExpression(elExpr).getValue(ctx);strLen = elParser.parseExpression(elLengthExpr).getValue(ctx);Object varVal = elParser.parseExpression("#var." + elExpr).getValue(ctx);System.out.println("===使用ctx传入变量和root对象==");System.out.println(elLengthExpr + " : " + strLen);System.out.println(elExpr + " : " + value);System.out.println("#var." + elExpr + " : " + varVal);
}
以上代码执行结果如下:
===测试字符串===
小游戏 地心侠士
===使用getValue传入具体的对象==
#root.length(): 8
substring(4,8)+' 小游戏 '+(333+333):地心侠士 小游戏 666
===使用ctx传入变量和root对象==
#root.length() : 8
substring(4,8)+' 小游戏 '+(333+333) : 地心侠士 小游戏 666
#var.substring(4,8)+' 小游戏 '+(333+333) : 地心侠士 小游戏 666
从执行结果可以知道,在传递具体实例对象是,就是调用 setRootObject ,针对根对象,可以使用#root.methodName(args)也可以直接调用方法 methodName(args)
3. 调用构造函数
语法:new className() 测试 String 构造函数,日期格式化构造函数同java日期对象结合,已经一个简单pojo对象
public void testInstanceCtor() {String strCtor = "new String('小游戏 地心侠士')";ExpressionParser elParser = new SpelExpressionParser();Object strVal = elParser.parseExpression(strCtor).getValue();System.out.println(strCtor + ": " + strVal);String cotrExpr = "new java.text.SimpleDateFormat('yyyy-MM-dd HH:mm:ss')";SimpleDateFormat df = (SimpleDateFormat) elParser.parseExpression(cotrExpr).getValue();System.out.println("当前时间: " + df.format(new Date()));String innerEl = "new com.herbert.script.SpringElScript.ElTestObject('小游戏','地心侠士')";ElTestObject value = elParser.parseExpression(innerEl).getValue(ElTestObject.class);System.out.println(value);ElTestObject javaObj = new ElTestObject("小游戏", "地心侠士");Object gameName = elParser.parseExpression("gameName").getValue(javaObj);System.out.println("获取java对象上的值:" + gameName);
}
以上代码,执行结果如下
new String('小游戏 地心侠士'): 小游戏 地心侠士
当前时间: 2025-11-29 21:54:55
ElTestObject [gameType=小游戏, gameName=地心侠士]
获取java对象上的值:地心侠士
从这是结果可以知道getValue初始的后的对象,已经就是java对象,可以直接获取对象属性.两者之间,可以相互穿插调用.
针对 Map 和 List 构造函数,也提供了一种内联的方式初始方式
Map 语法:{key:value}
List 语法:{value1,value2,value3}
public void testInlineMapAndList() {String initMap = "{'gameType':'小游戏','gameName':'地心侠士'}";String initList = "{'小游戏','地心侠士'}";ExpressionParser elParser = new SpelExpressionParser();Map map = elParser.parseExpression(initMap).getValue(Map.class);System.out.println("===通过{key:value}初始的内容===");System.out.println(String.format("%s : %s ", map.get("gameType"), map.get("gameName")));List lst = elParser.parseExpression(initList).getValue(List.class);System.out.println("===通过{value,value}初始的内容===");System.out.println(String.format("%s : %s ", lst.get(0), lst.get(1)));
}
执行结果如下:
===通过{key:value}初始的内容===
小游戏 : 地心侠士
===通过{value,value}初始的内容===
小游戏 : 地心侠士
4. 获取SpringBean
语法:@beanName,如果不在Spring环境,需要实现一个BeanResolver接口,这里只测试Spring环境中.
在Springboot中注册一个bean
@Bean
public Map elMap() {Map elMap = new HashMap();elMap.put("gameType", "小游戏");elMap.put("gameName", "地心侠士");return elMap;
}
测试代码如下,这个特别地方需要使用BeanFactoryResolver包装 applicationContext 放到context中
@Autowired
ApplicationContext applicationContext;public void testSpringBean() {Consumer<Map> printMap = map -> {System.out.println(map.get("gameType") + ": " + map.get("gameName"));};System.out.println("=====使用 Autowired 获取到bean内容=======");printMap.accept(elMap);Map ctxElMap = (Map) applicationContext.getBean("elMap");System.out.println("=====使用 applicationContext 获取到bean内容=======");printMap.accept(ctxElMap);String beanStr = "@elMap";ExpressionParser elParser = new SpelExpressionParser();StandardEvaluationContext elContext = new StandardEvaluationContext();// 注册spring BeanResolverelContext.setBeanResolver(new BeanFactoryResolver((BeanFactory) applicationContext));Map convertMap = (Map) elParser.parseExpression(beanStr).getValue(elContext);System.out.println("=====使用 el 获取到bean内容(BeanResolver)=======");printMap.accept(convertMap);
}
执行结果如下:
=====使用 Autowired 获取到bean内容=======
小游戏: 地心侠士
=====使用 applicationContext 获取到bean内容=======
小游戏: 地心侠士
=====使用 el 获取到bean内容(BeanResolver)=======
小游戏: 地心侠士
5. 获取List元素
语法:list[index]
public void testGetListValue() {ArrayList<String> datas = new ArrayList<>();datas.add("小游戏");datas.add("地心侠士");String listEL = "'使用Variable '+#ary[0] +' : '+#ary[1]";System.out.println("==SPEL 获取LIST采用 对象[index] 方式==");ExpressionParser elParser = new SpelExpressionParser();StandardEvaluationContext elContext = new StandardEvaluationContext();elContext.setVariable("ary", datas);Object value = elParser.parseExpression(listEL).getValue(elContext);System.out.println(value);// 测试rootObjeelContext.setRootObject(datas);listEL = "'使用rootObjet: '+#root[0] + ' : '+#root[1]";value = elParser.parseExpression(listEL).getValue(elContext);System.out.println(value);System.out.println("数组'[1]'获取到的值:"+elParser.parseExpression("[1]").getValue(elContext));
}
执行结果如下:
==SPEL 获取LIST采用 对象[index] 方式==
使用Variable 小游戏 : 地心侠士
使用rootObjet: 小游戏 : 地心侠士
数组'[1]'获取到的值:地心侠士
6. 获取Map元素
语法:map[key]或者map.get(key)
public void testGetMapEntryValue() {String beanStr = "@elMap.get('gameType')+' : ' + @elMap.get('gameName')";ExpressionParser elParser = new SpelExpressionParser();StandardEvaluationContext elContext = new StandardEvaluationContext();elContext.setBeanResolver(new BeanFactoryResolver((BeanFactory) applicationContext));Object mapvalue = elParser.parseExpression(beanStr).getValue(elContext);System.out.println("===SPEL 获取Map采用 对象.get('mapkey') 方式===");System.out.println(mapvalue);mapvalue = elParser.parseExpression("@elMap['gameType']+' : '+@elMap['gameName']").getValue(elContext);System.out.println("===SPEL 获取Map采用 对象['mapkey'] 方式===");System.out.println(mapvalue);}
执行结果如下:
===SPEL 获取Map采用 对象.get('mapkey') 方式===
小游戏 : 地心侠士
===SPEL 获取Map采用 对象['mapkey'] 方式===
小游戏 : 地心侠士
7. 集合筛选
语法:
list.?[condition]过滤集合list.^[condition]返回过滤后的第一个list.$[condition]返回过滤后的最后一个list.![condition]投影,类似flatmap,会改变筛选集合类型
public void testCollectionFilterAndFlatMap() {List datas = Arrays.asList(new String[] { "小游戏", "地心侠士1", "地心侠士2" });Map mapData = new HashMap() {{put("gameType", "小游戏");put("gameName", "地心侠士");}};String el = "#root.?[#this.contains('地心侠士')]";System.out.println("===筛选List===");ExpressionParser elParser = new SpelExpressionParser();List filterList = elParser.parseExpression(el).getValue(datas, List.class);filterList.forEach(System.out::println);System.out.println("===list快速获取第一个===");el = "#root.^[#this.contains('地心侠士')]";Object value = elParser.parseExpression(el).getValue(datas);System.out.println(value);System.out.println("===list快速获取最后一个===");el = "#root.$[#this.contains('地心侠士')]";value = elParser.parseExpression(el).getValue(datas);System.out.println(value);System.out.println("===筛选Map按key筛选===");el = "#root.?[key=='gameName']";Map filterMap = elParser.parseExpression(el).getValue(mapData, Map.class);filterMap.keySet().forEach(System.out::println);System.out.println("===筛选Map按value筛选===");el = "#root.?[value=='地心侠士']";filterMap = elParser.parseExpression(el).getValue(mapData, Map.class);filterMap.keySet().forEach(System.out::println);System.out.println("===提取Map所有Value===");el = "#root.![value]";List flatMapList = elParser.parseExpression(el).getValue(mapData, List.class);flatMapList.forEach(System.out::println);
}
执行结果如下:
===筛选List===
地心侠士1
地心侠士2
===list快速获取第一个===
地心侠士1
===list快速获取最后一个===
地心侠士2
===筛选Map按key筛选===
gameName
===筛选Map按value筛选===
gameName
===提取Map所有Value===
小游戏
地心侠士
8. 实例赋值
语法: = 赋值 或者调用 Expression#setValue
public void testAssignmentValue() {ElTestObject obj = new ElTestObject();String elExpr = "gameName";ExpressionParser elParser = new SpelExpressionParser();elParser.parseExpression(elExpr).setValue(obj, "地心侠士");System.out.println("使用EL setValue :" + obj.getGameName());elExpr="gameName=#change";StandardEvaluationContext ctx = new StandardEvaluationContext(obj);ctx.setVariable("change", "小游戏");elParser.parseExpression(elExpr).getValue(ctx);System.out.println("使用EL = 赋值:" +obj.getGameName());
}
执行结果如下:
使用EL setValue :地心侠士
使用EL = 赋值:小游戏
9. 特殊语法
特殊语法为EL特有,在标准java中不支持的语法
9.1 空判断语法 ?:'a',如果值为空则返回'a'
public void testNullShort() {String nullStr = "null?:'空值出现'";ExpressionParser elParser = new SpelExpressionParser();Object value = elParser.parseExpression(nullStr).getValue();System.out.println("?: 空值表达式值: " + value);
}
执行结果如下:
?: 空值表达式值: 空值出现
9.2 安全导航操作符?.aa,如果属性值aa不为空返回aa否则返回null
public void testSafeNav() {ElTestObject t = new ElTestObject();t.setGameName("地心侠士");String el = "gameName?.substring(0,2)";ExpressionParser elParser = new SpelExpressionParser();System.out.println("至空前运行结果: "+ elParser.parseExpression(el).getValue(t));t.setGameName(null);System.out.println("至空后运行结果: "+ elParser.parseExpression(el).getValue(t));try {System.out.println("至空后不使用结果: "+ elParser.parseExpression("gameName.substring(0,1)").getValue(t));} catch (Exception e) {System.out.println("未使用?.表达式,出现NPE异常");} }
执行结果如下:
至空前运行结果: 地心
至空后运行结果: null
未使用?.表达式,出现NPE异常
9.3 属性可以使用索引方式访问,特殊如String[0],可以返回第一个字符,类似charAt(index)
public void testIndexAccess() {ElTestObject obj = new ElTestObject("小游戏", "地心侠士");String el = "['gameName']";ExpressionParser elParser = new SpelExpressionParser();System.out.println("===使用[]访问属性===");Object value = elParser.parseExpression(el).getValue(obj);System.out.println(value);System.out.println("===使用[]访问String===");el = "[1]+#root.length";value = elParser.parseExpression(el).getValue("地心侠士");System.out.println("el[1]: "+value);System.out.println("charAt(1): "+"地心侠士".charAt(1));
}
执行结果如下:
===使用[]访问属性===
地心侠士
===使用[]访问String===
el[1]: 心4
charAt(1): 心
9.4 字符串支持 * - 操作符,但是特别注意-只支持单字符串.
public void testStringOperator() {String el = "'地心侠士 '*2";ExpressionParser elParser = new SpelExpressionParser();Object value = elParser.parseExpression(el).getValue();System.out.println("===*操作符效果===");System.out.println(value);el = "'c'-2";value = elParser.parseExpression(el).getValue();System.out.println("===-操作符效果===");System.out.println(value);
}
执行结果如下:
===*操作符效果===
地心侠士 地心侠士
===-操作符效果===
a
9.5 操作符 < <= > >= == != 同 lt le gt ge eq ne; && || ! 同 and or not; / %同 div mod 这三组都是等价的; 在使用中需要前后添加一个空格
public void testSameOperator() {String el = "1 gt 2";ExpressionParser elParser = new SpelExpressionParser();Object value = elParser.parseExpression(el).getValue();System.out.println("=== > 换成 gt ===");System.out.println(value);el = "2 >1 and 2>2";value = elParser.parseExpression(el).getValue();System.out.println("=== && 换 and ===");System.out.println(value);el = "4 div 2";value = elParser.parseExpression(el).getValue();System.out.println("=== / 换 div ===");System.out.println(value);
}
执行结果如下:
=== > 换成 gt ===
false
=== && 换 and ===
false
=== / 换 div ===
2
9.6 操作符支持 between 和 正则 matches
public void testbetweenMatch() {String el = "'b' between {'a','c'}";ExpressionParser elParser = new SpelExpressionParser();Object value = elParser.parseExpression(el).getValue();System.out.println("===b 是否在 ac 之间===");System.out.println(value);el="'123' matches '^\\d{3}$'";value = elParser.parseExpression(el).getValue();System.out.println("===matches 检测三位数字 ===");System.out.println(value);
}
输出结果如下:
===b 是否在 ac 之间===
true
===matches 检测三位数字 ===
true
10. 总结
语法汇总:
T(className)获取class对象new className(xx,xx)创建对象@beanName获取bean对象{value1,value2}简便创建数组{'key1':'value'}简便创建map#root获取根对象#variable获取变量#this获取当前对象,集合筛选中使用method()或者#variable.method调用方法property或者#variable.property获取属性[index]或者[propertyName]获取集合元素或对象属性list.?[condition]筛选集合元素list.?^[condition]返回筛选后的第一个元素list.?$[condition]返回筛选后的最后一个元素list.![propertyName]集合投影?:'value'空值判类似if(value==null){value='value'}property?.method()安全导航操作符,如果属性值不为空则返回属性值,否则返回nullsetValue或者 '=' 属性赋值+-*/%<<=>>===!=&&||!betweenmatchesinstanceof操作符,支持等价的转义符:lt le gt ge eq ne and or not div modstring * number表述复制nubmer个string
以上是基本的取值,赋值,筛选的基本操作语法.下期分享安全和扩展,如果需要完整测试代码,请在微信公众号:小满小慢 回复spel获取完整测试代码.
原文地址: https://mp.weixin.qq.com/s/6nXCJjrX2zAudd4KpFkANQ