- 当前位置：首页 >娱乐 >Spring Boot参数校验以及分组校验的使用
Spring Boot参数校验以及分组校验的使用
发布时间：2025-11-05 13:48:13 来源：创站工坊 作者：系统运维
一 前言
做web开发有一点很烦人就是参数要对前端输入参数进行校验，基本上每个接口都要对参数进行校验，校验比如一些非空校验、及分格式校验等。组校如果参数比较少的使用话还是容易处理的一但参数比较多了的话代码中就会出现大量的if-else语句。
使用这种方式虽然简单直接，参数但是校验也有不好的地方，一是及分降低了开发效率，因为我们需要校验的组校参数会存在很多地方，并且不同地方会有重复校验，使用其次降低了代码可读性，参数因为在业务代码中掺杂了太多额外工作的校验代码。
所以我们可以使用validator组件来代替我们进行不必要的及分coding操作。本文基于validator的组校介绍资料，也结合自己在项目中的使用实际使用经验进行了总结，希望能帮到大家。
1 什么是validator
Bean Validation是Java定义的一套基于注解的香港云服务器数据校验规范，目前已经从JSR 303的1.0版本升级到JSR 349的1.1版本，再到JSR 380的2.0版本(2.0完成于2017.08)，已经经历了三个版本 。需要注意的是，JSR只是一项标准，它规定了一些校验注解的规范，但没有实现，比如@Null、@NotNull、@Pattern等，它们位于 javax.validation.constraints这个包下。而hibernate validator是对这个规范的实现，并增加了一些其他校验注解，如 @NotBlank、@NotEmpty、@Length等，它们位于org.hibernate.validator.constraints这个包下。
如果我们的项目使用了Spring Boot，hibernate validator框架已经集成在 spring-boot-starter-web中，所以无需再添加其他依赖。如果不是Spring Boot项目，云服务器提供商需要添加如下依赖。
<dependency> <groupId>org.hibernate.validator</groupId> <artifactId>hibernate-validator</artifactId> <version>6.0.8.Final</version> </dependency>二 注解介绍
1 validator内置注解
注解 说明 @Null 被注释的元素必须为null @NotNull 被注释的元素不能为null @AssertTrue 被注释的元素必须为true @AssertFalse 被注释的元素必须为false @Min(value) 被注释的元素必须是一个数字，其值必须大于等于指定的最小值 @Max(value) 被注释的元素必须是一个数字，其值必须小于等于指定的最大值 @DecimalMin(value) 被注释的元素必须是一个数字，其值必须大于等于指定的最小值 @DecimalMax(value) 被注释的元素必须是一个数字，其值必须小于等于指定的最大值 @Size(max,min) 被注释的元素的大小必须在指定的范围内 @Digits(integer, fraction) 被注释的元素必须是一个数字，其值必须必须在可接受的范围内 @Past 被注释的元素必须是一个过去的日期 @Future 被注释的元素必须是站群服务器一个将来的日期 @Pattern(value) 被注释的元素必须符合指定的正则表达式hibernate validator中扩展定义了如下注解：
注解 说明 @NotBlank 被注释的元素不能为null，且长度必须大于0，只能用于注解字符串 @Email 被注释的元素必须是电子邮箱地址 @Length(min=,max=) 被注释的字符串的大小必须在指定的范围内 @NotEmpty 被注释的元素值不为null且不为空，支持字符串、集合、Map和数组类型 @Range 被注释的元素必须在规定的范围内
三 使用
使用起来比较简单，都是使用注解方式使用。具体来说分为单参数校验、对象参数校验，单参数校验就是controller接口按照单参数接收前端传值，没有封装对象进行接收，如果有封装对象那就是对象参数校验。
1 单参数校验
单参数校验只需要在参数前添加注解即可，如下所示：
public Result deleteUser(@NotNull(message = "id不能为空") Long id) { // do something }但有一点需要注意，如果使用单参数校验，controller类上必须添加@Validated注解，如下所示：
@RestController @RequestMapping("/user") @Validated // 单参数校验需要加的注解 public class UserController { // do something }2 对象参数校验
对象参数校验使用时，需要先在对象的校验属性上添加注解，然后在Controller方法的对象参数前添加@Validated 注解，如下所示：
public Result addUser(@Validated UserAO userAo) { // do something } public class UserAO { @NotBlank private String name; @NotNull private Integer age; …… }注解分组
在对象参数校验场景下，有一种特殊场景，同一个参数对象在不同的场景下有不同的校验规则。比如，在创建对象时不需要传入id字段(id字段是主键，由系统生成，不由用户指定)，但是在修改对象时就必须要传入id字段。在这样的场景下就需要对注解进行分组。
1)组件有个默认分组Default.class, 所以我们可以再创建一个分组UpdateAction.class，如下所示：
public interface UpdateAction { }2)在参数类中需要校验的属性上，在注解中添加groups属性：
public class UserAO { @NotNull(groups = UpdateAction.class, message = "id不能为空") private Long id; @NotBlank private String name; @NotNull private Integer age; …… }如上所示，就表示只在UpdateAction分组下校验id字段，在默认情况下就会校验name字段和age字段。
然后在controller的方法中，在@Validated注解里指定哪种场景即可，没有指定就代表采用Default.class，采用其他分组就需要显示指定。如下代码便表示在addUser()接口中按照默认情况进行参数校验，在updateUser()接口中按照默认情况和UpdateAction分组对参数进行共同校验。
public Result addUser(@Validated UserAO userAo) { // do something } public Result updateUser(@Validated({Default.class, UpdateAction.class}) UserAO userAo) { // do something }对象嵌套
如果需要校验的参数对象中还嵌套有一个对象属性，而该嵌套的对象属性也需要校验，那么就需要在该对象属性上增加@Valid注解。
public class UserAO { @NotNull(groups = UpdateAction.class, message = "id不能为空") private Long id; @NotBlank private String name; @NotNull private Integer age; @Valid private Phone phone; …… } public class Phone { @NotBlank private String operatorType; @NotBlank private String phoneNum; }3 错误消息的捕获
参数校验失败后会抛出异常，我们只需要在全局异常处理类中捕获参数校验的失败异常，然后将错误消息添加到返回值中即可。捕获异常的方法如下所示，返回值Result是我们系统自定义的返回值类。
@RestControllerAdvice(basePackages= {"com.alibaba.dc.controller","com.alibaba.dc.service"}) public class GlobalExceptionHandler { @ExceptionHandler(value = {Throwable.class}) Result handleException(Throwable e, HttpServletRequest request){ // 异常处理 } }需要注意的是，如果缺少参数抛出的异常是MissingServletRequestParameterException，单参数校验失败后抛出的异常是ConstraintViolationException，get请求的对象参数校验失败后抛出的异常是BindException，post请求的对象参数校验失败后抛出的异常是MethodArgumentNotValidException，不同异常对象的结构不同，对异常消息的提取方式也就不同。如下图所示：
1)MissingServletRequestParameterException
if(e instanceof MissingServletRequestParameterException){ Result result = Result.buildErrorResult(ErrorCodeEnum.PARAM_ILLEGAL); String msg = MessageFormat.format("缺少参数", ((MissingServletRequestParameterException) e).getParameterName()); result.setMessage(msg); return result; }2)ConstraintViolationException异常
if(e instanceof ConstraintViolationException){ // 单个参数校验异常 Result result = Result.buildErrorResult(ErrorCodeEnum.PARAM_ILLEGAL); Set<ConstraintViolation<?>> sets = ((ConstraintViolationException) e).getConstraintViolations(); if(CollectionUtils.isNotEmpty(sets)){ StringBuilder sb = new StringBuilder(); sets.forEach(error -> { if (error instanceof FieldError) { sb.append(((FieldError)error).getField()).append(":"); } sb.append(error.getMessage()).append(";"); }); String msg = sb.toString(); msg = StringUtils.substring(msg, 0, msg.length() -1); result.setMessage(msg); } return result; }3)BindException异常
if (e instanceof BindException){ // get请求的对象参数校验异常 Result result = Result.buildErrorResult(ErrorCodeEnum.PARAM_ILLEGAL); List<ObjectError> errors = ((BindException) e).getBindingResult().getAllErrors(); String msg = getValidExceptionMsg(errors); if (StringUtils.isNotBlank(msg)){ result.setMessage(msg); } return result; } private String getValidExceptionMsg(List<ObjectError> errors) { if(CollectionUtils.isNotEmpty(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 = StringUtils.substring(msg, 0, msg.length() -1); return msg; } return null; }4)MethodArgumentNotValidException异常
if (e instanceof MethodArgumentNotValidException){ // post请求的对象参数校验异常 Result result = Result.buildErrorResult(ErrorCodeEnum.PARAM_ILLEGAL); List<ObjectError> errors = ((MethodArgumentNotValidException) e).getBindingResult().getAllErrors(); String msg = getValidExceptionMsg(errors); if (StringUtils.isNotBlank(msg)){ result.setMessage(msg); } return result; }【本文为专栏作者“阿里巴巴官方技术”原创稿件，转载请联系原作者】
戳这里，看该作者更多好文
- 如何通过电脑上货链接（电脑上货链接教程及步骤详解）
- 电脑插无线网卡连接实用技巧（快速稳定上网，解决无线信号问题）
- 小辣椒S33质量评测（小辣椒S33性能、外观、拍照和续航表现全面解析）
- 使用Y700设置U盘启动教程（一步步教你在Y700电脑上设置U盘启动）
- 探索小创客教育的创新之路（培养创造力和实践能力的小创客教育模式）
- CPU超频超坏了的危害与后果（避免CPU超频后果，谨慎操作！）
- 以乐心T1为主题的智能手环产品介绍（探索乐心T1的功能与特点，带您走进智能健康时代）
- 电脑重装系统的详细步骤（手把手教你重装系统，轻松解决电脑问题）
- Ubuntu12.04server上自己编译PHP5.3，比繁琐，共享之。安装Apache2.2复制代码代码如下:sudo apt-get install mysql-server-5.5 -y接着就是编译依赖环境：复制代码代码如下:sudo apt-get install libxml2 libxml2-dev libevent-1.4-2 libevent-dev bzip2 libbz2-dev libcurl3-gnutls libcurl4-gnutls-dev libpng12-0 libpng12-dev libjpeg62 libjpeg62-dev libfreetype6 libfreetype6-dev libmcrypt4 libmcrypt-dev zlib1g-dev libtidy-dev libmysqlclient-dev -y 复制代码代码如下:复制代码代码如下:sudo apt-get install php5-cli php5-dev最后开启Apache2支持：复制代码代码如下:sudo apt-get install libapache2-mod-php5最后就大功告成了~
- 探索S34E790C显示器的卓越表现力（领先行业的4K超宽曲面显示器，逐梦前行）
- 以疯卖酷品——探索独特品牌营销方式（创新、激情、疯狂，为酷品打造销售奇迹）
- 以群联东芝固态硬盘的性能与可靠性评测（高速读写、持久耐用，东芝固态硬盘让你的电脑焕发新生）
- 使用U盘安装Win7镜像的详细教程（简单步骤让您轻松安装Win7系统）
- 如何在惠普电脑上安装XP系统（详细教程带你轻松操作，让你的电脑重焕活力）
- 小米电脑系统重新安装教程（以小米电脑重新做系统的步骤和注意事项）
- 电脑C盘满了怎么清理？（有效方法让C盘腾出更多空间）
- 三星笔记本（解析三星笔记本的独特魅力与出众表现）
- Xemal音响（探索音乐的极致享受，Xemal音响带来无与伦比的听觉盛宴）
- 下面给出装这个工具的方法： 复制代码代码如下: sudo add-apt-repository ppa:atareao/atareao sudo apt-get update sudo apt-get install touchpad-indicator
- Win7Ghost换电脑系统安装教程（简单易懂的Win7Ghost换电脑系统安装指南，轻松实现系统迁移）
随便看看
- Copyright © 2025 Powered by Spring Boot参数校验以及分组校验的使用,创站工坊 滇ICP备2023006006号-44sitemap