Spring Boot @Validated 校验

本文主要是介绍Spring Boot @Validated 校验，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

Spring Boot 可以使用@Validated对入参进行校验

引入pom依赖，查看其依赖发现，底层是基于hibernate-validator实现

        <!-- 验证 --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-validation</artifactId></dependency>

一、 初步使用

package com.learn.validate.domain;  
import javax.validation.constraints.Min;  
import javax.validation.constraints.NotBlank;public class Student {  
//在需要校验的字段上指定约束条件  @NotBlank(message="姓名不能为空")  private String name;  @Min(3)  private int age;  @NotBlank  private String classess;  public String getName() {  return name;  }  public void setName(String name) {  this.name = name;  }  public int getAge() {  return age;  }  public void setAge(int age) {  this.age = age;  }  public String getClassess() {  return classess;  }  public void setClassess(String classess) {  this.classess = classess;  }  }  

然后在controller中可以这样调用，加上@Validated注解即可。

package com.learn.validate.controller;  
import org.springframework.validation.annotation.Validated;  
import org.springframework.web.bind.annotation.RequestMapping;  
import org.springframework.web.bind.annotation.RestController;  import com.learn.validate.domain.Student;  @RestController  
public class ValidateController {  @RequestMapping(value="testStudent")  public void testStudent(@Validated Student student) {  }  
}  

    如果校验失败，默认会返回Spring boot 框架的出错信息。是一个json串，里面有详细的出错描述。可以配合Spring Boot的统一异常处理类，进行统一处理，给前端返回统一格式的数据；

二、使用gruops 属性来实现区别不同的校验需求

    在上面的例子中，如果Student bean想要用于两个不同的请求中，每个请求有不同的校验需求，

例如一个请求只需要校验name字段,一个请求需要校验name和age两个字段，那该怎么做呢？

使用注解的groups属性可以很好的解决这个问题,如下所示：

package com.learn.validate.domain;  
import javax.validation.constraints.Min;  import javax.validation.constraints.NotBlank;  public class Student {  
//使用groups属性来给分组命名，然后在需要的地方指定命令即可  
@NotBlank(groups=NAME.class)  
private String name;  
@Min(value=3,groups=AGE.class)  
private int age;  
@NotBlank  
private String classess;  
public String getName() {  
return name;  
}  
public void setName(String name) {  
this.name = name;  
}  
public int getAge() {  
return age;  
}  
public void setAge(int age) {  
this.age = age;  
}  
public String getClassess() {  
return classess;  
}  
public void setClassess(String classess) {  
this.classess = classess;  
}  
public interface NAME{};  
public interface AGE{};  }  

   根据需要在@Validated属性中指定需要校验的分组名，可以指定1到多个。指定到的分组名会全部进行校验,不指定的不校验。这样我们可以在不同的校验中使用不同分组（这里仅是功能示例）

package com.learn.validate.controller;  import org.springframework.validation.annotation.Validated;  
import org.springframework.web.bind.annotation.RequestMapping;  
import org.springframework.web.bind.annotation.RestController;  import com.learn.validate.domain.Student;  
import com.learn.validate.domain.Student.AGE;  
import com.learn.validate.domain.Student.NAME;  @RestController  
public class ValidateController {  @RequestMapping(value="testStudent")  
public void testStudent(@Validated Student student) {  
}  
@RequestMapping(value="testStudent1")  
public void testStudent1(@Validated(NAME.class) Student student) {  
}  
@RequestMapping(value="testStudent2")  
public void testStudent2(@Validated({NAME.class,AGE.class}) Student student) {  
}  }  

三、使用 @ScriptAssert 注解校验复杂的业务逻辑

     如果需要校验的业务逻辑比较复杂，简单的@NotBlank，@Min注解已经无法满足需求了，这时可以使用 @ScriptAssert 来指定进行校验的方法，通过方法来进行复杂业务逻辑的校验，然后返回 true或false来表明是否校验成功。例如下面的例子：

package com.learn.validate.domain;  
import javax.validation.constraints.Min;  import org.hibernate.validator.constraints.NotBlank;  
import org.hibernate.validator.constraints.ScriptAssert;  import com.learn.validate.domain.Student.CHECK;  
//通过script 属性指定进行校验的方法，传递校验的参数，  
//依然可以通过groups属性指定分组名称  
@ScriptAssert(lang="javascript",script="com.learn.validate.domain.Student.checkParams(_this.name,_this.age,_this.classes)",  
groups=CHECK.class)  
public class Student {  @NotBlank(groups=NAME.class)  private String name;  @Min(value=3,groups=AGE.class)  private int age;  @NotBlank  private String classess;  public String getName() {  return name;  }  public void setName(String name) {  this.name = name;  }  public int getAge() {  return age;  }  public void setAge(int age) {  this.age = age;  }  public String getClassess() {  return classess;  }  public void setClassess(String classess) {  this.classess = classess;  }  public interface NAME{};  public interface AGE{};  public interface CHECK{};  //注意进行校验的方法要写成静态方法，否则会出现   //TypeError: xxx is not a function 的错误  public static boolean checkParams(String name,int age,String classes) {  if(name!=null&&age>8&classes!=null)  {  return true;  }  else  {  return false;  }  }  }  

在需要的地方，通过分组名称进行调用。

package com.learn.validate.controller;  import org.springframework.validation.annotation.Validated;  
import org.springframework.web.bind.annotation.RequestMapping;  
import org.springframework.web.bind.annotation.RestController;  import com.learn.validate.domain.Student;  
import com.learn.validate.domain.Student.CHECK;  @RestController  
public class ValidateController {  @RequestMapping(value="testStudent3")  public void testStudent3(@Validated(CHECK.class) Student student) {  }  
}  

另外：

@Validated 和 @Valid 区别

• @Valid用于嵌套类校验，表示该对象也参与整体校验，其和@NotBlank都是javax包下的注解；
• @Validated是spring自己的注解，用来告诉spring这里需要进行校验；

package com.learn.validate.domain;  
import javax.validation.constraints.Min;  
import javax.validation.constraints.NotBlank;class Classes {@NotBlankprivate String className;
}public class Student {  
//在需要校验的字段上指定约束条件  @NotBlank  private String name;  @Min(3)  private int age;  @Validprivate Classes classes;  public String getName() {  return name;  }  public void setName(String name) {  this.name = name;  }  public int getAge() {  return age;  }  public void setAge(int age) {  this.age = age;  }  }  

这篇关于Spring Boot @Validated 校验的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！