SqEL表达式功能介绍，使用场景说明，以及完整示例

SpEL（Spring Expression Language，Spring 表达式语言）。它是 Spring 框架提供的一种强大的表达式语言，支持在运行时查询和操作对象图。

以下是对 SpEL 的功能介绍、使用场景说明以及完整的代码示例：

一、 SpEL 核心功能介绍

SpEL 提供了丰富的语法，主要包含以下核心功能：

1. 字面量与基本运算：支持字符串、数字、布尔值、null 等字面量，以及算术运算符（+, -, *, /, %, ^）、关系运算符（==, !=, <, > 等）和逻辑运算符（and, or, not）。
2. 属性访问与方法调用：可以通过点号（.）访问对象的属性或调用方法，支持嵌套属性访问。
3. 安全导航运算符：使用 ?. 可以避免在访问可能为 null 的对象属性时抛出空指针异常（如 user?.email）。
4. 集合操作：
   • 选择（Selection）：使用 ?[] 从集合中筛选符合条件的元素（如 users.?[age > 25]）。
   • 投影（Projection）：使用 ![] 提取集合中元素的特定属性（如 users.![username]）。
5. 类与静态成员访问：使用 T(类的全路径名) 来引用类的静态变量或调用静态方法（如 T(java.lang.Math).PI）。
6. 条件与正则表达式：支持三目运算符（? :）、Elvis 运算符（?:，用于提供默认值），以及使用 matches 关键字进行正则表达式匹配。

二、 常见使用场景

1. Bean 属性动态注入：在 XML 配置文件或 @Value 注解中，动态计算属性值、注入系统环境变量或读取其他 Bean 的属性。
2. 方法参数动态解析：在 AOP 或自定义注解中，通过 SpEL 解析方法参数，常用于实现防重复提交、分布式锁的 Key 生成等。
3. 安全与权限控制：在 Spring Security 中，使用 @PreAuthorize、@PostAuthorize 等注解结合 SpEL 进行细粒度的权限校验（如 !hasRole('ROLE_ADMIN')）。
4. 独立的数据处理：SpEL 是一个技术中立的 API，可以脱离 Spring 容器独立使用，在普通 Java 代码中动态解析和执行字符串表达式。

三、 完整使用示例

1. 在注解和 XML 配置中使用

// 1. 注入系统属性
@Value("#{systemProperties['user.name']}")
private String userName;

// 2. 调用静态方法并计算
@Value("#{T(Math).random() * 100.0}")
private double randomNumber;

// 3. 安全导航与默认值（Elvis运算符）
@Value("#{userService.findUser(1)?.username ?: 'Unknown'}")
private String defaultUsername;

// 4. 集合筛选与投影
@Value("#{userService.users.?[age > 25]}")
private List<User> adults;

@Value("#{userService.users.![username]}")
private List<String> usernames;

<!-- 在 XML 中使用 SpEL -->
<bean id="dataSource" class="com.zaxxer.hikari.HikariDataSource">
    <property name="jdbcUrl" value="#{systemProperties['db.url']}"/>
    <property name="maxPoolSize" value="#{10 + 5}"/>
</bean>

2. 在 Java 代码中独立使用

// 1. 创建解析器
ExpressionParser parser = new SpelExpressionParser();

// 2. 基本运算与字符串拼接
String hello = parser.parseExpression("'Hello, ' + 'SpEL!'").getValue(String.class);
int sum = parser.parseExpression("1 + 2 + 3").getValue(Integer.class);

// 3. 访问对象属性与方法
User user = new User("张三", 25);
String username = parser.parseExpression("username").getValue(user, String.class);
String upperName = parser.parseExpression("username.toUpperCase()").getValue(user, String.class);

// 4. 结合上下文（EvaluationContext）使用变量
StandardEvaluationContext context = new StandardEvaluationContext();
context.setVariable("myList", Arrays.asList("a", "b", "c"));
String firstItem = parser.parseExpression("#myList[0]").getValue(context, String.class);

// 5. 集合筛选
List<User> users = Arrays.asList(new User("张三", 30), new User("李四", 20));
List<User> filteredUsers = parser.parseExpression("#root.?[age >= 25]")
                                 .getValue(users, List.class);

⚠️ 语法提示：SpEL 表达式通常包裹在 #{} 中（如 #{表达式}），请注意不要与读取外部配置文件的占位符 ${property.name} 混淆。两者可以混合使用，例如 #{${someProperty} + 5}。