SpEL 表达式

本章只介绍一些重要的 SpEL 表达式用法，更详细的使用说明请参考官方文档。

官方文档：Spring Expression Language (SpEL)

提示

如果你的 IDEA 版本比较新，理论上来说，IDEA 应该能够识别到表达式，并且会给出提示，也具备引用的功能。

基本操作符

此部分由GPT生成，进行了部分删减。

1. 算术操作符

   • + 加法
   • - 减法
   • * 乘法
   • / 除法
   • % 取模

2. 关系操作符

   • == 等于
   • != 不等于
   • < 小于
   • <= 小于等于
   • > 大于
   • >= 大于等于

3. 逻辑操作符

   • && 逻辑与
   • || 逻辑或
   • ! 逻辑非

4. 条件操作符（三元操作符）

   • ? : 条件表达式，类似于 Java 中的 ? :

5. 成员访问

   • . 属性访问
   • [] 属性访问（使用字符串键）

6. 集合操作符

   • in 判断元素是否在集合中
   • !in 判断元素是否不在集合中

7. 空安全操作符

   • ?. 空安全属性访问
   • :? 空安全方法调用

8. 空合并操作符

   • ?: 当左侧表达式为 null 时，返回右侧表达式的值

调用静态方法

调用静态方法的语法为：T(全类名).方法名(参数)。

@Data
@SpelValid
public class SimpleExampleParamVo {

  /**
   * 枚举值字段校验
   */
  @SpelAssert(assertTrue = " T(cn.sticki.enums.UserStatusEnum).getByCode(#this.userStatus) != null ", message = "用户状态不合法")
  private Integer userStatus;

  // 中文算两个字符，英文算一个字符，要求总长度不超过 10
  // 调用外部静态方法进行校验
  @SpelAssert(assertTrue = "T(cn.sticki.util.StringUtil).getLength(#this.userName) <= 10", message = "用户名长度不能超过10")
  private String userName;

}

调用 Spring Bean

开启 Spring Bean 支持后，即可在 SpEL 表达式中调用 Spring Bean。

调用 Bean 的语法为：@beanName.methodName(参数)。

@Data
@SpelValid
public class SimpleExampleParamVo {

  /**
   * 调用 userService 的 getById 方法，判断用户是否存在
   * 校验失败时，提示信息为：用户不存在
   * 这里只是简单举例，实际开发中不建议这样判断用户是否存在
   */
  @SpelAssert(assertTrue = "@userService.getById(#this.userId) != null", message = "用户不存在")
  private Long userId;

}