Hibernate-Validation的使用和常用的注解

首先是要加入下面两个包

hibernate-validator-4.1.0.Final.jar
 validation-api-1.0.0.GA.jar

 

如果在验证不通过的时候进行了添加、更新或删除操作的时候，则会抛出javax.validation.ConstraintViolationException异常

下面是测试用的类

 

1. @RequestMapping(value = "/save.action", method = RequestMethod.POST)  
2. public String save(@Validated( { Second.class }) UserModel userModel, BindingResult result) {  
3.     if (result.hasErrors()) {  
4.         return "validate/error";  
5.     }  
6.     return "redirect:/success";  
7. }  
8.   
9. @RequestMapping(value = "/update.action", method = RequestMethod.POST)  
10. public String update(@Validated( { First.class, Second.class }) UserModel user, BindingResult result) {  
11.     if (result.hasErrors()) {  
12.         return "validate/error";  
13.     }  
14.     return "redirect:/success";  
15. } 

Model2：

Java代码  

1. import javax.persistence.Entity;  
2. import javax.persistence.GeneratedValue;  
3. import javax.persistence.GenerationType;  
4. import javax.persistence.Id;  
5. import javax.persistence.ManyToOne;  
6. import javax.persistence.Table;  
7. import javax.persistence.TableGenerator;  
8. import javax.validation.Valid;  
9. import javax.validation.constraints.Max;  
10. import javax.validation.constraints.Min;  
11. import javax.validation.constraints.NotNull;  
12. import javax.validation.constraints.Size;  
13.   
14. import org.hibernate.validator.constraints.Email;  
15. import org.hibernate.validator.constraints.URL;  
16.   
17. @Entity  
18. @Table(name="t_Model2")  
19. @TableGenerator(name="mytable",initialValue=1,allocationSize=1)  
20. public class Model2 {  
21.   
22.     private int id;  
23.     private String name;  
24.     private String address;  
25.     private String phoneNumber;  
26.     private String email;  
27.     private int age;  
28.     private Model3 model3;  
29.     private String url;  
30.   
31.     @Id  
32.     @GeneratedValue(generator="mytable",strategy=GenerationType.TABLE)  
33.     public int getId() {  
34.         return id;  
35.     }  
36.   
37.     public void setId(int id) {  
38.         this.id = id;  
39.     }  
40.   
41.     @NotNull(message="姓名不能为空！")  
42.     public String getName() {  
43.         return name;  
44.     }  
45.   
46.     public void setName(String name) {  
47.         this.name = name;  
48.     }  
49.   
50.     @NotNull(message="地址不能为空！")  
51.     public String getAddress() {  
52.         return address;  
53.     }  
54.   
55.     public void setAddress(String address) {  
56.         this.address = address;  
57.     }  
58.   
59.     @Size(max=11,min=11,message="长度只能为11位！")  
60.     public String getPhoneNumber() {  
61.         return phoneNumber;  
62.     }  
63.   
64.     public void setPhoneNumber(String phoneNumber) {  
65.         this.phoneNumber = phoneNumber;  
66.     }  
67.   
68.     @Email(message="email地址无效！")  
69.     @NotNull(message="email地址不能为空！")  
70.     public String getEmail() {  
71.         return email;  
72.     }  
73.   
74.     public void setEmail(String email) {  
75.         this.email = email;  
76.     }  
77.   
78.     @NotNull(message = "Model3不能为空！")  
79.     @Valid  
80.     @ManyToOne  
81.     public Model3 getModel3() {  
82.         return model3;  
83.     }  
84.   
85.     public void setModel3(Model3 model3) {  
86.         this.model3 = model3;  
87.     }  
88.   
89.     @Min(value=18,message="必须年满18岁！")  
90.     @Max(value=30,message="年龄不能大于30岁！")  
91.     public int getAge() {  
92.         return age;  
93.     }  
94.   
95.     public void setAge(int age) {  
96.         this.age = age;  
97.     }  
98.   
99.     @URL(message="无效的URL地址")  
100.     @NotNull(message = "URL不能为空！")  
101.     public String getUrl() {  
102.         return url;  
103.     }  
104.   
105.     public void setUrl(String url) {  
106.         this.url = url;  
107.     }  
108.       
109. }  

 Model3：

Java代码  

1. import javax.persistence.Entity;  
2. import javax.persistence.GeneratedValue;  
3. import javax.persistence.Id;  
4. import javax.persistence.Table;  
5. import javax.validation.constraints.NotNull;  
6.   
7. @Entity  
8. @Table(name="t_Model3")  
9. public class Model3 {  
10.   
11.     private int id;  
12.       
13.     private String name;  
14.   
15.     @Id  
16.     @GeneratedValue  
17.     public int getId() {  
18.         return id;  
19.     }  
20.   
21.     public void setId(int id) {  
22.         this.id = id;  
23.     }  
24.   
25.     @NotNull(message="model3的名称不能为空！")  
26.     public String getName() {  
27.         return name;  
28.     }  
29.   
30.     public void setName(String name) {  
31.         this.name = name;  
32.     }  
33.       
34. }  

 

Test类：

Java代码  

1. import org.springframework.context.ApplicationContext;  
2.   
3. import com.tiantian.test.model.Model2;  
4. import com.tiantian.test.service.Model2Service;  
5. import com.tiantian.test20110430.util.Util;  
6.   
7. public class Test1 {  
8.   
9.     public static void main(String args[]) {  
10.         ApplicationContext context = Util.getContext();  
11.         Model2Service service = context.getBean(Model2Service.class);  
12.         Model2 model = new Model2();  
13.         model.setName("hello");  
14.         model.setEmail("testHibernateValidate@sohu.com");  
15.         model.setAddress("湖南长沙");  
16.         model.setPhoneNumber("15012345678");  
17.   
18.         String result = Util.validateModel(model);// 返回的验证结果，验证结果就是一个字符串，如果有错误的话则该字符串的长度大于0  
19.         System.out.println(result);  
20.         if (result.length() == 0)// 验证不通过的时候就不添加  
21.             service.add(model);  
22.   
23.     }  
24.   
25. }  

 

 上面用到的Util类：

Java代码  

1. import java.util.Iterator;  
2. import java.util.Set;  
3.   
4. import javax.validation.ConstraintViolation;  
5. import javax.validation.Validation;  
6. import javax.validation.Validator;  
7.   
8. import org.springframework.context.ApplicationContext;  
9. import org.springframework.context.support.ClassPathXmlApplicationContext;  
10.   
11. public class Util {  
12.   
13.     private static ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");  
14.       
15.     public static ApplicationContext getContext() {  
16.         return context;  
17.     }  
18.       
19.     public static String validateModel(Object obj) {//验证某一个对象  
20.           
21.         StringBuffer buffer = new StringBuffer(64);//用于存储验证后的错误信息  
22.           
23.         Validator validator = Validation.buildDefaultValidatorFactory()  
24.                 .getValidator();  
25.   
26.         Set<ConstraintViolation<Object>> constraintViolations = validator  
27.                 .validate(obj);//验证某个对象,，其实也可以只验证其中的某一个属性的  
28.   
29.         Iterator<ConstraintViolation<Object>> iter = constraintViolations  
30.                 .iterator();  
31.         while (iter.hasNext()) {  
32.             String message = iter.next().getMessage();  
33.             buffer.append(message);  
34.         }  
35.         return buffer.toString();  
36.     }  
37.       
38. }  

 

 

下面是一些主要的注解：

Java代码  

1. @AssertTrue //用于boolean字段，该字段只能为true  
2. @AssertFalse//该字段的值只能为false  
3. @CreditCardNumber//对信用卡号进行一个大致的验证  
4. @DecimalMax//只能小于或等于该值  
5. @DecimalMin//只能大于或等于该值  
6. @Digits(integer=2,fraction=20)//检查是否是一种数字的整数、分数,小数位数的数字。  
7. @Email//检查是否是一个有效的email地址  
8. @Future//检查该字段的日期是否是属于将来的日期  
9. @Length(min=,max=)//检查所属的字段的长度是否在min和max之间,只能用于字符串  
10. @Max//该字段的值只能小于或等于该值  
11. @Min//该字段的值只能大于或等于该值  
12. @NotNull//不能为null  
13. @NotBlank//不能为空，检查时会将空格忽略  
14. @NotEmpty//不能为空，这里的空是指空字符串  
15. @Null//检查该字段为空  
16. @Past//检查该字段的日期是在过去  
17. @Size(min=, max=)//检查该字段的size是否在min和max之间，可以是字符串、数组、集合、Map等  
18. @URL(protocol=,host,port)//检查是否是一个有效的URL，如果提供了protocol，host等，则该URL还需满足提供的条件  
19. @Valid//该注解只要用于字段为一个包含其他对象的集合或map或数组的字段，或该字段直接为一个其他对象的引用，  
20.         //这样在检查当前对象的同时也会检查该字段所引用的对象  

@NotEmpty,@NotNull和@NotBlank的区别

1 @NotEmpty :不能为null，且Size>0

2  @NotNull:不能为null，但可以为empty,没有Size的约束

3  @NotBlank:只用于String,不能为null且trim()之后size>0

内置的验证约束注解如下表所示（摘自hibernate validator reference）：

验证注解	验证的数据类型	说明
@AssertFalse	Boolean,boolean	验证注解的元素值是false
@AssertTrue	Boolean,boolean	验证注解的元素值是true
@NotNull	任意类型	验证注解的元素值不是null
@Null	任意类型	验证注解的元素值是null
@Min(value=值)	BigDecimal，BigInteger, byte, short, int, long，等任何Number或CharSequence（存储的是数字）子类型	验证注解的元素值大于等于@Min指定的value值
@Max（value=值）	和@Min要求一样	验证注解的元素值小于等于@Max指定的value值
@DecimalMin(value=值)	和@Min要求一样	验证注解的元素值大于等于@ DecimalMin指定的value值
@DecimalMax(value=值)	和@Min要求一样	验证注解的元素值小于等于@ DecimalMax指定的value值
@Digits(integer=整数位数, fraction=小数位数)	和@Min要求一样	验证注解的元素值的整数位数和小数位数上限
@Size(min=下限, max=上限)	字符串、Collection、Map、数组等	验证注解的元素值的在min和max（包含）指定区间之内，如字符长度、集合大小
@Past	java.util.Date, java.util.Calendar; Joda Time类库的日期类型	验证注解的元素值（日期类型）比当前时间早
@Future	与@Past要求一样	验证注解的元素值（日期类型）比当前时间晚
@NotBlank	CharSequence子类型	验证注解的元素值不为空（不为null、去除首位空格后长度为0），不同于@NotEmpty，@NotBlank只应用于字符串且在比较时会去除字符串的首位空格
@Length(min=下限, max=上限)	CharSequence子类型	验证注解的元素值长度在min和max区间内
@NotEmpty	CharSequence子类型、Collection、Map、数组	验证注解的元素值不为null且不为空（字符串长度不为0、集合大小不为0）
@Range(min=最小值, max=最大值)	BigDecimal,BigInteger,CharSequence, byte, short, int, long等原子类型和包装类型	验证注解的元素值在最小值和最大值之间
@Email(regexp=正则表达式, flag=标志的模式)	CharSequence子类型（如String）	验证注解的元素值是Email，也可以通过regexp和flag指定自定义的email格式
@Pattern(regexp=正则表达式, flag=标志的模式)	String，任何CharSequence的子类型	验证注解的元素值与指定的正则表达式匹配
@Valid	任何非原子类型	指定递归验证关联的对象； 如用户对象中有个地址对象属性，如果想在验证用户对象时一起验证地址对象的话，在地址对象上加@Valid注解即可级联验证