简介:做web开发基本上每个接口都要对参数进行校验,如果参数比拟少,还比拟容易解决,一但参数比拟多了的话代码中就会呈现大量的if-else语句。尽管这种形式简略间接,但会大大降低开发效率和代码可读性。所以咱们能够应用validator组件来代替咱们进行不必要的coding操作。本文将基于validator的介绍材料,同时联合作者本人在我的项目中的理论应用教训进行了总结。

作者 | 江岩
起源 | 阿里技术公众号

一 前言

做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我的项目,须要增加如下依赖。

二 注解介绍

1 validator内置注解

hibernate validator中扩大定义了如下注解:

三 应用

应用起来比较简单,都是应用注解形式应用。具体来说分为单参数校验、对象参数校验,单参数校验就是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("短少参数{0}", ((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;}

《一站式大数据开发治理DataWorks应用宝典》官网电子书凋谢下载

DataWorks官网入门电子书出版啦,零根底入门大数据开发治理,全面理解DataWorks十大功能模块,疾速上手DataWorks外围性能。

点击这里,即可下载~

版权申明:本文内容由阿里云实名注册用户自发奉献,版权归原作者所有,阿里云开发者社区不领有其著作权,亦不承当相应法律责任。具体规定请查看《阿里云开发者社区用户服务协定》和《阿里云开发者社区知识产权爱护指引》。如果您发现本社区中有涉嫌剽窃的内容,填写侵权投诉表单进行举报,一经查实,本社区将立即删除涉嫌侵权内容。