Springboot 使用 JSR 303 对 Controller 控制层校验及 Service 服务层 AOP 校验 使用消息资源文件对消息国际化

<dependency>  <groupId>org.hibernate.validator</groupId>  <artifactId>hibernate-validator</artifactId>  <version>6.0.5.Final</version></dependency><dependency>  <groupId>javax.validation</groupId>  <artifactId>validation-api</artifactId>  <version>2.0.0.Final</version></dependency>

@SpringBootApplicationpublic class Application extends WebMvcConfigurerAdapter {  @Value("${spring.messages.basename}")  private String basename;  public static void main(String[] args) {    SpringApplication.run(Application.class, args);  }  @Bean  @Primary  public MessageSource messageSource() {    ResourceBundleMessageSource resourceBundleMessageSource = new ResourceBundleMessageSource();    resourceBundleMessageSource.setUseCodeAsDefaultMessage(false);    resourceBundleMessageSource.setDefaultEncoding("UTF-8"); // 重复定义    resourceBundleMessageSource.setBasenames(basename.split(","));    return resourceBundleMessageSource;  }  @Bean  @Primary  public LocalValidatorFactoryBean validator() {    LocalValidatorFactoryBean validatorFactoryBean = new LocalValidatorFactoryBean();    validatorFactoryBean.setProviderClass(HibernateValidator.class);    validatorFactoryBean.setValidationMessageSource(messageSource());    return validatorFactoryBean;  }  @Override  public Validator getValidator() {    return validator();  }  /**   * 方法级别的单个参数验证开启   */  @Bean  public MethodValidationPostProcessor methodValidationPostProcessor() {    return new MethodValidationPostProcessor();  }}

@ControllerAdvice@Componentpublic class BindValidExceptionHandler {  @ResponseStatus(value = HttpStatus.OK)  @ExceptionHandler(ConstraintViolationException.class)  public @ResponseBody  Msg handleConstraintViolationException(ConstraintViolationException e) {    String messageTemplate = e.getConstraintViolations().iterator().next().getMessageTemplate();    return Msg.error(messageTemplate);  }  @ResponseStatus(value = HttpStatus.OK)  @ExceptionHandler(BindException.class)  public @ResponseBody  Msg handleBindException(BindException e) {    BindingResult bindingResult = e.getBindingResult();    String className = bindingResult.getTarget().getClass().getName();    FieldError next = bindingResult.getFieldErrors().iterator().next();    String fieldName = next.getField();    String defaultMessage = next.getDefaultMessage();    if (Pattern.compile("IllegalArgumentException: No enum").matcher(defaultMessage).find()) {      Matcher matcher = Pattern.compile("for value '(.*?)'").matcher(defaultMessage);      if (matcher.find()) {        defaultMessage = "找不到枚举类型【" + matcher.group(1) + "】";      }    }    return Msg.error(defaultMessage);  }  @ResponseStatus(value = HttpStatus.OK)  @ExceptionHandler(ValidError.class)  public @ResponseBody  Msg handleValidError(ValidError e) {    return Msg.error(e.getMessage());  }}

/** * 私有 id，是代表项目任务/非项目任务/风险/问题/评审待办问题等多张表的外键 */@Min(value = 1, message = "{todo.privateId.min}", groups = {C.Insert.class, C.Update.class, S.Insert.class, S.Update.class})private long privateId;/** * 创建者id */@Min(value = 1, message = "{creatorId}", groups = {S.Insert.class})private long creatorId;Controller 控制层验证@Validated@RestController@RequestMapping("todo")public class TodoController {  @Autowired  private TodoService todoService;  @GetMapping("getVo")  public Msg getVo(    @Min(value = 1, message = "待办 id 不能小于 1。")    @RequestParam(required = false, defaultValue = "0")    long id  ) {    return this.todoService.getVo(id);  }  @PostMapping("add")  public Msg add(@Validated({C.Insert.class}) Todo todo) {    return this.todoService.add(todo);  }}

@Componentpublic class ValidUtil {  @Autowired  private Validator validator;  public <T> Set<ConstraintViolation<T>> validate(T object, Class<?>... groups) {    return validator.validate(object, groups);  }  public <T> Set<ConstraintViolation<T>> validateValue(Class<T> beanType, String propertyName, Object value, Class<?>... groups) {    return validator.validateValue(beanType, propertyName, value, groups);  }  /**   * 校验参数，并返回第一个错误提示   * @param t   验证的对象   * @param groups 验证的组别   * @param <T>  对象擦除前原类型   * @return 第一个错误提示   */  public <T> void validAndReturnFirstErrorTips(T t, Class<?>... groups) {    Set<ConstraintViolation<T>> validate = validator.validate(t, groups);    if (validate.size() > 0) {      ConstraintViolation<T> next = validate.iterator().next();      String message = next.getRootBeanClass().getName() + "-" + next.getPropertyPath() + "-" + next.getMessage();      throw new ValidError(message);    }  }  /**   * 校验参数，并返回第一个错误提示   * @param targetClass 验证的对象的 class 类型   * @param fieldName  需要验证的名字   * @param obj     需要属性值   * @param groups   验证的组别   * @param <T>     对象擦除前原类型   * @return 第一个错误提示   */  public <T> void validAndReturnFirstErrorTips(Class targetClass, String fieldName, Object obj, Class<?>... groups) {    Set<ConstraintViolation<T>> validate = validator.validateValue(targetClass, fieldName, obj, groups);    if (validate.size() > 0) {      String message = targetClass.getName() + "-" + fieldName + "-" + validate.iterator().next().getMessage();      throw new ValidError(message);    }  }}

@Aspect@Componentpublic class ValidatorAOP {  @Autowired  private ValidUtil validUtil;  /**   *  定义拦截规则：拦截 com.servic  包下面的所有类中，有 @Service 注解的方法。   */  @Pointcut("execution(* com.service..*(..)) and @annotation(org.springframework.stereotype.Service)")  public void controllerMethodPointcut() {  }  /**   *  拦截器具体实现   */  @Around("controllerMethodPointcut()") // 指定拦截器规则；也可以直接把 “execution(* com.xjj.........)” 写进这里  public Object Interceptor(ProceedingJoinPoint pjp) {    MethodSignature methodSignature = (MethodSignature) pjp.getSignature();    Method method = methodSignature.getMethod();    Annotation[][] argAnnotations = method.getParameterAnnotations();    Object[] args = pjp.getArgs();    for (int i = 0; i < args.length; i++) {      for (Annotation annotation : argAnnotations[i]) {        if (Validated.class.isInstance(annotation)) {          Validated validated = (Validated) annotation;          Class<?>[] groups = validated.value();          validUtil.validAndReturnFirstErrorTips(args[i], groups);        }      }    }    try {      return pjp.proceed(args);    } catch (Throwable throwable) {      throwable.printStackTrace();    }    return true;  }}

@Validatedpublic interface TodoService {  /**   * 查询 单个待办   * @param id 序号   * @return 单个待办   */  Msg getVo(@Min(value = 1, message = "待办 id 不能小于 1。") long id);  /**   * 添加数据   * @param todo 对象   */  Msg add(@Validated({S.Insert.class}) Todo todo);}

package javax.validation.constraints;import javax.validation.Constraint;import javax.validation.ConstraintValidator;import javax.validation.ConstraintValidatorContext;import javax.validation.Payload;import java.lang.annotation.*;/** * 字符串判空验证，hibernate 自带的可能有问题，使用不了，需要重写，package 是不能变的。 */@Documented@Constraint(    validatedBy = {NotBlank.NotBlankValidator.class})@Target({ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.PARAMETER})@Retention(RetentionPolicy.RUNTIME)public @interface NotBlank {  Class<?>[] groups() default {};  String message() default "{notBlank}";  Class<? extends Payload>[] payload() default {};  class NotBlankValidator implements ConstraintValidator<NotBlank, Object> {    public NotBlankValidator() {    }    @Override    public void initialize(NotBlank constraintAnnotation) {    }    @Override    public boolean isValid(Object value, ConstraintValidatorContext context) {      return value != null && !value.toString().isEmpty();    }  }}

resources/todo.propertiestodo.todoType.insert=新增时，待办类型只能是 非项目任务、项目任务、问题 之中一。todo.todoType.update=修改时，待办类型只能是风险、评审待办问题 之中一。bean/** * 待办类型0非项目任务1项目任务2问题3风险4评审待办问题 */@TodoTypeValid(value = {"0", "1", "2"}, message = "{todo.todoType.insert}", groups = {C.Insert.class, S.Insert.class})@TodoTypeValid(value = {"3", "4"}, message = "{todo.todoType.update}", groups = {C.Update.class, S.Update.class})private String todoType;

@Documented@Constraint(validatedBy = {TodoTypeValid.TodoTypeValidFactory.class})@Target({ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.PARAMETER})@Retention(RetentionPolicy.RUNTIME)@Repeatable(TodoTypeValid.List.class)public @interface TodoTypeValid {  String message() default "请输入正确的类型";  String[] value() default {};  Class<?>[] groups() default {};  Class<? extends Payload>[] payload() default {};  class TodoTypeValidFactory implements ConstraintValidator<TodoTypeValid, String> {    private String[] annotationValue;    @Override    public void initialize(TodoTypeValid todoStatusValid) {      this.annotationValue = todoStatusValid.value();    }    @Override    public boolean isValid(String value, ConstraintValidatorContext context) {      if (Arrays.asList(annotationValue).contains(value))        return true;      return false;    }  }  @Target({ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.PARAMETER})  @Retention(RetentionPolicy.RUNTIME)  @Documented  @interface List {    TodoTypeValid[] value();  }}

resources/todo.propertiestodo.todoStatus.insert=新增时，状态只能是未开始。todo.todoStatus.update=修改时，状态只能是进行中或已完成。bean/** * 待办状态0未开始1进行中2已完成 */@TodoStatusValid(enums = {TodoStatus.NOT_STARTED}, message = "{todo.todoStatus.insert}", groups = {C.Insert.class, S.Insert.class})@TodoStatusValid(enums = {TodoStatus.PROCESSING, TodoStatus.COMPLETED}, message = "{todo.todoStatus.update}", groups = {C.Update.class, S.Update.class})private TodoStatus todoStatus;

@Documented@Constraint(validatedBy = {TodoStatusValid.TodoStatusValidFactory.class})@Target({ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.PARAMETER})@Retention(RetentionPolicy.RUNTIME)@Repeatable(TodoStatusValid.List.class)public @interface TodoStatusValid {  String message() default "请输入正确的状态";  TodoStatus[] enums() default {};  Class<?>[] groups() default {};  Class<? extends Payload>[] payload() default {};  class TodoStatusValidFactory implements ConstraintValidator<TodoStatusValid, TodoStatus> {    private TodoStatus[] enums;    @Override    public void initialize(TodoStatusValid todoStatusValid) {      this.enums = todoStatusValid.enums();    }    @Override    public boolean isValid(TodoStatus value, ConstraintValidatorContext context) {      TodoStatus[] values = TodoStatus.values();      if (enums != null && enums.length != 0) {        values = enums;      }      if (Arrays.asList(values).contains(value))        return true;      return false;    }  }  @Target({ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.PARAMETER})  @Retention(RetentionPolicy.RUNTIME)  @Documented  @interface List {    TodoStatusValid[] value();  }}