SpringBoot 2 快速整合 | Hibernate Validator 数据校验 - 桌前明月

SpringBoot 2 快速整合 | Hibernate Validator 数据校验

概述

在开发RESTFull API 和普通的表单提交都需要对用户提交的数据进行校验，例如：用户姓名不能为空，年龄必须大于0 等等。这里我们主要说的是后台的校验，在 SpringBoot 中我们可以通过使用 Hibernate Validator 来进行后台的数据校验的。

闲话少说！接下来就开始介绍如何使用 Hibernate Validator 来进行数据的校验。

Hibernate Validator 实战操作

我们在添加用户的功能基础上来进行改造。

用户Model类代码如下：

public class User {
    private String name;
    private Integer age;
    //省略get and set 方法
}

用户Controller代码如下：

   @RequestMapping(value = "",method = RequestMethod.POST)
   public void add(User user){
       log.info("添加用户成功："+"name:{},age:{}",user.getName(),user.getAge());
   }

第一步我们先在 User 类上添加校验的注解，具体代码如下：

public class User {
  @NotEmpty(message="请输入您的名称！")
  private String name;
  @Max(value = 100, message = "年龄必须在20-100之间！")
  @Min(value= 20 ,message= "年龄必须在20-100之间！" )
  private Integer age;
  ..省略get 和set 方法
}

我们来大致说明一下注解的含义：

注解中message ： 如果字段信息和检验规则不符合提示的错误信息。
注解中的value: 表示字段信息限定的值。
@NotEmpty : 表示name 变量不能为空。
@Max: 表示年龄的最大值是多少。
@Min: 表示年龄的最小值是多少。

第二步就是对用户添加方法进行改造

用户添加方法中的 User 参数需要声明 @Valid 注解，添加该注解主要是指定要校验的参数实例，然后在添加用户方法中添加 BindingResult 参数。
BindingResult：主要是存储校验结果的数据，我们可以通过 BindingResult 来判断校验是否通过和获取校验错误提示信息。

具体代码如下：

  @PostMapping()
  public User add(@Valid User user,BindingResult bindingResult){
  	if(bindingResult.hasErrors()) {
  		String defaultMessage = bindingResult.getFieldError().getDefaultMessage();
  		System.out.println(defaultMessage);
  		return null;
      }
      log.info("springboot添加用户成功："+"name:{},age:{}",user.getName(),user.getAge());
  	return user;
  }