SpringBoot Validation入参校验国际化的项目实践
作者:无语堵上西楼
在Spring Boot中,可以使用Validation和国际化来实现对入参的校验,本文就来介绍一下SpringBoot Validation入参校验国际化,具有一定的参考价值,感兴趣的可以了解一下
在 Spring Boot 中,可以使用 Validation 和国际化来实现对入参的校验。
常用的校验
@NotNull | 验证字段值不能为 null |
@NotEmpty | 验证字段值不能为 null 或空字符串 |
@NotBlank | 验证字符串字段值不能为空、null,并且必须至少包含一个非空白字符 |
@Size | 验证字符串、集合或数组的大小是否在指定范围内 |
@Min | 验证数值字段值必须大于等于指定的最小值 |
@Max | 验证数值字段值必须小于等于指定的最大值 |
验证字段值必须是有效的电子邮件地址格式 | |
@Pattern | 验证字段值必须匹配指定的正则表达式模式 |
@Past | 验证日期字段值必须是过去的日期 |
@Future | 验证日期字段值必须是将来的日期 |
引入依赖
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-validation</artifactId> </dependency>
创建properties文件
安装插件
创建文件
添加语言
添加配置
语言配置
非空配置
长度配置
解决properties文件中文乱码
mode添加注解
@NotBlank
注解用于验证字符串类型字段不为空或不为 null。如果验证失败,则使用 message
属性中定义的错误消息提示用户输入不能为空或 null 值。
@Length
注解用于验证字符串类型字段的长度是否符合指定的范围。如果验证失败,就会使用 message
属性中定义的错误消息提示用户输入的长度非法。
/** * 学生姓名 */ @NotBlank(message = "{name.notBlank}") @Length(min = 2,max = 19,message="{name.length}") private String name;
controller添加注解
@Validated
是 Spring Framework 提供的一个注解,用于在控制器方法级别或类级别上启用方法参数验证,以对请求参数进行验证。
@Valid
是 Java 标准库中的一个注解,它与 Bean Validation 规范(JSR 380)一起使用,用于启用对象级别验证。
@RestController @RequestMapping("/test") @Validated public class TestController { @PostMapping("/user") public ResponseResult<String> user(@Valid @RequestBody Student student) { return new ResponseResult<>("userToken"); } }
添加异常捕捉
这个类捕获参数异常
import com.example.demo.util.HttpCodeEnum; import com.example.demo.util.ResponseResult; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.http.HttpStatus; import org.springframework.util.CollectionUtils; import org.springframework.validation.FieldError; import org.springframework.validation.ObjectError; import org.springframework.web.bind.MethodArgumentNotValidException; import org.springframework.web.bind.MissingServletRequestParameterException; import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.ResponseStatus; import org.springframework.web.bind.annotation.RestControllerAdvice; import javax.servlet.http.HttpServletRequest; import java.util.List; @RestControllerAdvice public class GlobalExceptionHandler { private static final Logger log = LoggerFactory.getLogger(GlobalExceptionHandler.class); @Autowired private HttpServletRequest httpServletRequest; private final String sysError="系统出错"; // get请求的对象参数校验异常 @ResponseStatus(HttpStatus.BAD_REQUEST) @ExceptionHandler({MissingServletRequestParameterException.class}) public ResponseResult bindExceptionHandler(MissingServletRequestParameterException e) { String requestURI = httpServletRequest.getRequestURI(); log.error("请求地址'{}',get方式请求参数'{}'必传", requestURI,e.getParameterName()); return ResponseResult.errorResult(HttpCodeEnum.SYSTEM_ERROR.getCode(), e.getMessage()); } // post请求的对象参数校验异常 @ResponseStatus(HttpStatus.BAD_REQUEST) @ExceptionHandler({MethodArgumentNotValidException.class}) public ResponseResult methodArgumentNotValidHandler(MethodArgumentNotValidException e) { String requestURI = httpServletRequest.getRequestURI(); log.error("请求地址'{}',post方式请求参数异常'{}'", requestURI, e.getMessage()); List<ObjectError> allErrors = e.getBindingResult().getAllErrors(); return ResponseResult.errorResult(HttpCodeEnum.SYSTEM_ERROR.getCode(), getValidExceptionMsg(allErrors)); } private String getValidExceptionMsg(List<ObjectError> errors) { if(!CollectionUtils.isEmpty(errors)){ StringBuilder sb = new StringBuilder(); errors.forEach(error -> { if (error instanceof FieldError) { sb.append(((FieldError)error).getField()).append(":"); } sb.append(error.getDefaultMessage()).append(";"); }); String msg = sb.toString(); msg = msg.substring(0, msg.length() -1); return msg; } return null; } }
测试
name为空
name长度不符合
切换为英文
到此这篇关于SpringBoot Validation入参校验国际化的文章就介绍到这了,更多相关SpringBoot Validation入参校验国际化内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!