spring boot 1.4默認使用 hibernate validator 5.2.4 Final實現校驗功能。hibernate validator 5.2.4 Final是JSR 349 Bean Validation 1.1的具體實現。
How to disable Hibernate validation in a Spring Boot project
As [M. Deinum] mentioned in a comment on my original post, the solution is to set:
spring.jpa.properties.javax.persistence.validation.mode=none
In the application.properties file.
Additionally, this behaviour is described here (its easy to miss because no example is provided).
http://stackoverflow.com/questions/26764532/how-to-disable-hibernate-validation-in-a-spring-boot-project
一 初步使用
hibernate vilidator主要使用注解的方式對bean進行校驗,初步的例子如下所示:
package com.query; import javax.validation.constraints.Min; import org.hibernate.validator.constraints.NotBlank; public class Student { //在需要校驗的字段上指定約束條件 @NotBlank 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.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串,里面有詳細的出錯描述。
二 使用gruops 屬性來實現區別不同的校驗需求
在上面的例子中,如果Student bean想要用於兩個不同的請求中,每個請求有不同的校驗需求,例如一個請求只需要校驗name字段,一個請求需要校驗name和age兩個字段,那該怎么做呢?
使用注解的groups屬性可以很好的解決這個問題,如下所示:
package com.query; import javax.validation.constraints.Min; import org.hibernate.validator.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.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.query; 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.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) { } }
import java.util.Set; import javax.validation.ConstraintViolation; import javax.validation.Validation; import javax.validation.Validator; import javax.validation.ValidatorFactory; import javax.validation.constraints.Max; import javax.validation.constraints.Min; import javax.validation.constraints.NotNull; public class JavaxValidation { public static void main(String[] args) { Dog d = new Dog(); d.setName("小明"); d.setAge(2); ValidatorFactory vf = Validation.buildDefaultValidatorFactory(); Validator validator = vf.getValidator(); Set<ConstraintViolation<Dog>> set = validator.validate(d); for (ConstraintViolation<Dog> constraintViolation : set) { System.out.println(constraintViolation.getMessage()); } } } class Dog { @NotNull(message = "不能為空") private String name; @Min(value = 1, message = "最少為1") @Max(value = 20, message = "最大為20") private int age; 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; } }
https://my.oschina.net/p2ng/blog/336690