如何进行SpringBoot开发的集成参数校验

这期内容当中小编将会给大家带来有关如何进行SpringBoot开发的集成参数校验,文章内容丰富且以专业的角度为大家分析和叙述,阅读完这篇文章希望大家可以有所收获。

成都创新互联公司是一家集网站建设,无极企业网站建设,无极品牌网站建设,网站定制,无极网站建设报价,网络营销,网络优化,无极网站推广为一体的创新建站企业,帮助传统企业提升企业形象加强企业竞争力。可充分满足这一群体相比中小企业更为丰富、高端、多元的互联网需求。同时我们时刻保持专业、时尚、前沿,时刻以成就客户成长自我,坚持不断学习、思考、沉淀、净化自己,让我们为更多的企业打造出实用型网站。

对于 web服务来说,为防止非法参数对业务造成影响,在  Controller层一定要对参数进行校验!

简单使用

1.要在Springboot项目中加入参数校验功能首先得加入spring-boot-starter-validation依赖

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

2.然后给需要校验的字段添加上约束性注解,如我们对实体类参数进行校验

@Data public class ValidEntity{     private int id;     @NotBlank     private String appId;        @NotBlank     private String name;        @Email     private String email; }

常见约束注解如下:

注解功能
@AssertFalse可以为null,如果不为null的话必须为false
@AssertTrue可以为null,如果不为null的话必须为true
@DecimalMax设置不能超过最大值
@DecimalMin设置不能超过最小值
@Digits设置必须是数字且数字整数的位数和小数的位数必须在指定范围内
@Future日期必须在当前日期的未来
@Past日期必须在当前日期的过去
@Max最大不得超过此最大值
@Min最大不得小于此最小值
@NotNull不能为null,可以是空
@Null必须为null
@Pattern必须满足指定的正则表达式
@Size集合、数组、map等的size()值必须在指定范围内
@Email必须是email格式
@Length长度必须在指定范围内
@NotBlank字符串不能为null,字符串trim()后也不能等于“”
@NotEmpty不能为null,集合、数组、map等size()不能为0;字符串trim()后可以等于“”
@Range值必须在指定范围内
@URL必须是一个URL

注:此表格只是简单的对注解功能的说明,并没有对每一个注解的属性进行说明;可详见源码。

3.在Controller层对需要参数校验的方法加上@Validated注解

参数校验一般分为两类:在Controller使用模型接收数据时, @Validated注解直接放在该模型参数前即可。

@PostMapping(value = "test1") public String test1(@Validated @RequestBody ValidEntity validEntity){  return "test1 valid success"; }  @PostMapping(value = "test3") public String test3(@Validated ValidEntity validEntity){  return "test3 valid success"; }

当我们是直接在Controller层中的参数前,使用约束注解时,@Validated要直接放在类上

@PostMapping(value = "test2") public String test2(@Email String email){     return "test2 valid success"; }

此时需要在主类上增加@Validated注解

@Validated @RestController @RequestMapping("/demo/valid") public class ValidController {  ... }

在参数校验时我们既可以使用@Validated也可以使用@Valid注解,两者功能大部分类似;

主要区别在于:

@Valid属于javax下的,而@Validated属于spring下;

@Valid支持嵌套校验、而@Validated不支持,@Validated支持分组,而@Valid不支持。

统一异常处理

如果参数校验未通过Spring会抛出三种类型的异常

1.当对@RequestBody需要的参数进行校验时会出现org.springframework.web.bind.MethodArgumentNotValidException

如何进行SpringBoot开发的集成参数校验

当直接校验具体参数时会出现javax.validation.ConstraintViolationException,也属于ValidationException异常

如何进行SpringBoot开发的集成参数校验

当直接校验对象时会出现org.springframework.validation.BindException

如何进行SpringBoot开发的集成参数校验

在SpringBoot中统一拦截处理只需要在配置类上添加 @RestControllerAdvice注解,然后在具体方法中通过  @ExceptionHandler指定需要处理的异常,具体代码如下:

@RestControllerAdvice @Slf4j public class GlobalExceptionHandler {     public static final String ERROR_MSG = "系统异常,请联系管理员。";      @ExceptionHandler(value = {BindException.class, ValidationException.class, MethodArgumentNotValidException.class})     public ResponseEntity> handleValidatedException(Exception e) {         Result resp = null;          if (e instanceof MethodArgumentNotValidException) {             // BeanValidation exception             MethodArgumentNotValidException ex = (MethodArgumentNotValidException) e;             resp = new Result<>(Integer.toString(HttpStatus.BAD_REQUEST.value()),                     ex.getBindingResult().getAllErrors().stream().map(ObjectError::getDefaultMessage).collect(Collectors.joining(", "))                     , getStackTrace(ex));         } else if (e instanceof ConstraintViolationException) {             // BeanValidation GET simple param             ConstraintViolationException ex = (ConstraintViolationException) e;             resp = new Result<>(Integer.toString(HttpStatus.BAD_REQUEST.value()),                     ex.getConstraintViolations().stream().map(ConstraintViolation::getMessage).collect(Collectors.joining(", "))                     , getStackTrace(ex));         } else if (e instanceof BindException) {             // BeanValidation GET object param             BindException ex = (BindException) e;             resp = new Result<>(Integer.toString(HttpStatus.BAD_REQUEST.value()),                     ex.getAllErrors().stream().map(ObjectError::getDefaultMessage).collect(Collectors.joining(", "))                     , getStackTrace(ex));         }          return new ResponseEntity<>(resp,HttpStatus.BAD_REQUEST);     }       private String getStackTrace(Exception e) {         //打印日志开关,可通过配置读取         boolean printStrackTrace = false;         if(printStrackTrace){             StringWriter sw = new StringWriter();             e.printStackTrace(new PrintWriter(sw));             return sw.toString();         }else{             return ERROR_MSG;         }      }  }

最终实现效果如下:

如何进行SpringBoot开发的集成参数校验

参数分组

有下面一个实体类,我们需要对其进行参数校验。

@Data public class ValidEntity {     private int id;      @NotBlank     private String appId;      @NotBlank     private String name;      @Email     private String email; }

但是实际业务是在编辑的时候 appId才是必填,在新增的时候  name必填,这时候可以用groups分组功能来实现:同一个模型在不同场景下,动态区分校验模型中的不同字段。

使用方式

首先我们定义一个分组接口ValidGroup,再在分组接口总定义出多个不同的操作类型,Create,Update,Query,Delete

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

这里的 ValidGroup继承了Default,当然也可以不继承,具体区别我们后面再说。

在模型中给校验参数分配分组

@Data @ApiModel(value="ValidEntity") public class ValidEntity {     private int id;      @NotBlank(groups = ValidGroup.Crud.Update.class)     private String appId;      @NotBlank(groups = ValidGroup.Crud.Create.class)     private String name;      @Email     private String email; }

tips:这里@Email注解未指定分组,默认会属于Default分组,appId和name指定了分组就不会再属于Default分组了。

在参数校验时通过value属性指定分组

如何进行SpringBoot开发的集成参数校验

这里通过 @Validated(value =  ValidGroup.Crud.Update.class)指定了具体的分组,上面提到的是否继承Default的区别在于:

如果继承了Default,@Validated标注的注解也会校验未指定分组或者Default分组的参数,比如email

如果不继承Default则不会校验未指定分组的参数,需要加上@Validated(value =  {ValidGroup.Crud.Update.class, Default.class}才会校验

快速失败(Fali Fast)

默认情况下在对参数进行校验时Spring Validation会校验完所有字段然后才抛出异常,可以通过配置开启 Fali  Fast模式,一旦校验失败就立即返回。

@Configuration public class ValidatedConfig {      @Bean     public Validator validator() {         ValidatorFactory validatorFactory = Validation.byProvider(HibernateValidator.class)                 .configure()                 // 快速失败模式                 .failFast(true)                 .buildValidatorFactory();         return validatorFactory.getValidator();     } }

上述就是小编为大家分享的如何进行SpringBoot开发的集成参数校验了,如果刚好有类似的疑惑,不妨参照上述分析进行理解。如果想知道更多相关知识,欢迎关注创新互联行业资讯频道。


当前名称:如何进行SpringBoot开发的集成参数校验
本文网址:http://bzwzjz.com/article/ppipgp.html

其他资讯

Copyright © 2007-2020 广东宝晨空调科技有限公司 All Rights Reserved 粤ICP备2022107769号
友情链接: 手机网站制作设计 商城网站建设 成都网站建设 成都商城网站建设 app网站建设 网站制作 企业网站建设 成都网站设计 营销型网站建设 响应式网站设计方案 网站建设公司 成都商城网站制作 成都网站设计 高端网站设计 手机网站建设套餐 网站设计 成都网站建设 宜宾网站设计 响应式网站设计 网站制作 成都网站制作 成都网站建设公司