JAVA：Spring Boot 集成 Aviator 实现参数校验的技术指南

1、简述

在实际开发中，参数校验是保障系统稳定和数据可靠性的重要措施。常规的校验方式包括 JSR 303 的注解校验以及自定义校验逻辑，但对于一些复杂的条件判断，使用这些方式会导致代码变得冗余和难以维护。Aviator 是一个高性能的表达式引擎，它能够简化复杂的逻辑判断并提升参数校验的灵活性。本文将介绍如何在 Spring Boot 中集成 Aviator，并利用它来实现灵活的参数校验。

2、优势

Aviator 是由中国团队开源的一款高性能、轻量级的 Java 表达式引擎。它支持丰富的数据类型和操作符，能够处理复杂的逻辑运算和自定义函数。相比其他表达式引擎（如 MVEL 和 Groovy），Aviator 更轻量且性能更优，特别适合高并发场景下的动态计算和参数校验。

高性能：内部采用了字节码生成和优化，运行速度快。

灵活性：支持动态编写表达式，便于扩展复杂的校验规则。

轻量级：无需大量依赖，容易集成到 Spring Boot 项目中。

3、集成 Aviator

3.1 项目依赖

首先，确保你的 Spring Boot 项目中添加了 Aviator 依赖。在 pom.xml 文件中加入以下依赖：

<dependency>    <groupId>com.googlecode.aviator</groupId>    <artifactId>aviator</artifactId>    <version>5.2.0</version></dependency><dependency>    <groupId>org.springframework.boot</groupId>    <artifactId>spring-boot-starter-aop</artifactId></dependency>

3.2 定义自定义注解

接下来，我们定义一个自定义注解 @AviatorValidation 用于标记需要校验的方法参数。

import java.lang.annotation.ElementType;import java.lang.annotation.Retention;import java.lang.annotation.RetentionPolicy;import java.lang.annotation.Target;
@Retention(RetentionPolicy.RUNTIME)@Target(ElementType.METHOD)public @interface AviatorValidation {    String expression(); // Aviator表达式    String errorMessage() default "参数不符合要求"; // 错误信息}

3.3 创建 AOP 切面

然后，我们创建一个 AOP 切面 ValidationAspect，用于拦截方法调用，并执行参数校验逻辑。

import com.googlecode.aviator.AviatorEvaluator;import org.aspectj.lang.ProceedingJoinPoint;import org.aspectj.lang.annotation.Around;import org.aspectj.lang.annotation.Aspect;import org.aspectj.lang.reflect.MethodSignature;import org.springframework.stereotype.Component;
import java.lang.annotation.Annotation;import java.lang.reflect.Parameter;
@Aspect@Componentpublic class ValidationAspect {
    @Around("execution(* com.example.demo..*(.., @AviatorValidation (*), ..))")    public Object validate(ProceedingJoinPoint joinPoint) throws Throwable {        MethodSignature methodSignature = (MethodSignature) joinPoint.getSignature();        Parameter[] parameters = methodSignature.getMethod().getParameters();        Object[] args = joinPoint.getArgs();
        for (int i = 0; i < parameters.length; i++) {            Annotation[] annotations = parameters[i].getAnnotations();            for (Annotation annotation : annotations) {                if (annotation instanceof AviatorValidation) {                    String expression = ((AviatorValidation) annotation).expression();                    Object value = args[i];                                        // 使用 Aviator 进行表达式校验                    Boolean result = (Boolean) AviatorEvaluator.execute(expression, value);                    if (result == null || !result) {                        throw new IllegalArgumentException("参数校验失败： " + value);                    }                }            }        }        return joinPoint.proceed();    }}

3.4 在方法上使用注解

在需要校验的地方使用 @AviatorValidation 注解，指定校验表达式和错误信息。

import org.springframework.web.bind.annotation.GetMapping;import org.springframework.web.bind.annotation.RequestParam;import org.springframework.web.bind.annotation.RestController;
@RestControllerpublic class UserController {
    @GetMapping("/checkUser")    @AviatorValidation(expression = "arg0 != null && arg0.length >= 3 && arg0.length <= 20",                        errorMessage = "用户名不符合要求（3-20个字符）")    public String checkUser(@RequestParam String username) {        return "用户验证通过: " + username;    }
    @GetMapping("/checkAge")    @AviatorValidation(expression = "arg0 >= 18 && arg0 <= 60",                        errorMessage = "年龄必须在18到60之间")    public String checkAge(@RequestParam int age) {        return "年龄验证通过: " + age;    }}