前几天，一位粉丝让我为他实现一个基于Spring Boot的后端公共组件，需求如下：

1. 支持参数校验和分组校验。
2. 实现全局异常处理。
3. 接口统一响应，并且返回体需要加密。
4. 对接口实现版本控制。
5. 对接口参数进行加签，防止重放攻击，确保接口安全。

本文将详细介绍如何实现这些功能，帮助大家快速搭建符合这些需求的公共组件。

1. 参数校验及分组校验

在Spring Boot中，我们可以通过引入
spring-boot-starter-validation来实现参数校验。这允许我们在模型类上使用如@NotNull、@Email等注解，进行基础的校验。为了实现更细粒度的参数校验（如分组校验），我们可以自定义校验组。

1.1 引入依赖

首先，在pom.xml中加入
spring-boot-starter-validation依赖：

  
    org.springframework.boot  
    spring-boot-starter-validation  

1.2 实现分组校验

我们可以创建一个自定义接口让其继承
javax.validation.groups.Default类，用来定义不同的校验分组：

public interface ValidGroup extends Default {  
  
    interface Update extends ValidGroup{  
  
    }  
    interface Create  extends ValidGroup{  
  
    }  
    interface Query extends ValidGroup{  
  
    }  
    interface Delete extends ValidGroup{  
  
    }
}

使用时，可以在字段上指定校验分组：

 @NotNull(groups = ValidGroup.Update.class, message = "应用ID不能为空")
 private String appId;

这样，我们就能根据不同的场景进行灵活的参数校验。

2. 全局异常响应

为了统一处理项目中的异常，我们可以创建一个全局异常处理类，并使用@RestControllerAdvice注解进行标注。在Spring Boot组件中，我们需要通过spring.factories文件进行配置，确保Spring Boot自动识别并加载该配置类。

2.1 创建全局异常处理类

@Slf4j  
@RestControllerAdvice  
public class GlobalExceptionHandler {  
    // 处理参数验证异常  
    @SneakyThrows  
    @ExceptionHandler(value = {MethodArgumentNotValidException.class, BindException.class, ValidationException.class})  
    public Result handleValidException(HttpServletRequest request, Exception e) {  
        ...
        logError(request.getMethod(), getUrl(request),exceptionStr);  
        return ResultFactory.fail(ResultCode.CLIENT_ERROR, exceptionStr);  
    }  
  
    // 处理自定义异常  
    @ExceptionHandler(value = {AbstractException.class})  
    @ResponseStatus(code = HttpStatus.BAD_REQUEST)  
    public Result handleAbstractException(HttpServletRequest request, AbstractException ex) {  
        ...
        return ResultFactory.fail(ex);  
    }  
  
    // 兜底处理  
    @ExceptionHandler(value = Throwable.class)  
    public Result handleThrowable(HttpServletRequest request, Throwable throwable) {  
        return ResultFactory.fail(ResultCode.SERVICE_ERROR, "系统异常，请联系管理员!");  
    }  
  
    //记录日志  
    private void logError(String method, String requestUrl, String exceptionStr){  
        log.error("[{}] {} [ex] {}", method, requestUrl, exceptionStr);  
    }  
}

2.2 注册异常处理类

在组件的配置类中进行注册：

@SpringBootConfiguration  
@ConditionalOnWebApplication  
public class WebAutoConfiguration {  
    @Bean  
    @ConditionalOnMissingBean(GlobalExceptionHandler.class)  
    public GlobalExceptionHandler globalExceptionHandler() {  
        return new GlobalExceptionHandler();  
    }  
}

在spring.factories文件中指定配置类路径：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\  
  com.lxjk.core.web.configuration.WebAutoConfiguration

粉丝SpringBoot版本使用的是2.3，而在SpringBoot2.7以后路径变成
resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports/

3. 接口统一响应及返回体加密

为了统一返回接口响应体，并实现返回体加密，我们可以定义一个统一的返回类型Result，并通过ResponseBodyAdvice进行加密处理。

3.1 定义返回结果类

@Data
@Accessors(chain = true)
public class Result {
    
    public static final String SUCCESS_CODE = "OK";
    public static final String SUCCESS_MESSAGE = "操作成功";
    
    private String code;
    
    private String message;
    
    private T data;
    
    private long timestamp;
    
}

3.2 创建工具类

@Slf4j
public class ResultFactory {
    
    public static  Result success(T data) {
        return new Result()
                .setCode(SUCCESS_CODE)
                .setMessage(SUCCESS_MESSAGE)
                .setData(data)
                .setTimestamp(System.currentTimeMillis());
    }
    
    public static Result fail(String code, String message) {
        return new Result()
                .setCode(code)
                .setMessage(message)
                .setTimestamp(System.currentTimeMillis());
    }
    
}

3.3 返回体加密

为了保证数据安全，我们可以通过ResponseBodyAdvice对返回结果进行加密处理：

@Slf4j
@RestControllerAdvice
public class ResponseBodyEncryptAdvice implements ResponseBodyAdvice