首先是要加入下面两个包
hibernate-validator-4.1.0.Final.jar
validation-api-1.0.0.GA.jar
如果在验证不通过的时候进行了添加、更新或删除操作的时候,则会抛出javax.validation.ConstraintViolationException异常
下面是测试用的类
- @RequestMapping(value = "/save.action", method = RequestMethod.POST)
- public String save(@Validated( { Second.class }) UserModel userModel, BindingResult result) {
- if (result.hasErrors()) {
- return "validate/error";
- }
- return "redirect:/success";
- }
- @RequestMapping(value = "/update.action", method = RequestMethod.POST)
- public String update(@Validated( { First.class, Second.class }) UserModel user, BindingResult result) {
- if (result.hasErrors()) {
- return "validate/error";
- }
- return "redirect:/success";
- }
Model2:
- import javax.persistence.Entity;
- import javax.persistence.GeneratedValue;
- import javax.persistence.GenerationType;
- import javax.persistence.Id;
- import javax.persistence.ManyToOne;
- import javax.persistence.Table;
- import javax.persistence.TableGenerator;
- import javax.validation.Valid;
- import javax.validation.constraints.Max;
- import javax.validation.constraints.Min;
- import javax.validation.constraints.NotNull;
- import javax.validation.constraints.Size;
- import org.hibernate.validator.constraints.Email;
- import org.hibernate.validator.constraints.URL;
- @Entity
- @Table(name="t_Model2")
- @TableGenerator(name="mytable",initialValue=1,allocationSize=1)
- public class Model2 {
- private int id;
- private String name;
- private String address;
- private String phoneNumber;
- private String email;
- private int age;
- private Model3 model3;
- private String url;
- @Id
- @GeneratedValue(generator="mytable",strategy=GenerationType.TABLE)
- public int getId() {
- return id;
- }
- public void setId(int id) {
- this.id = id;
- }
- @NotNull(message="姓名不能为空!")
- public String getName() {
- return name;
- }
- public void setName(String name) {
- this.name = name;
- }
- @NotNull(message="地址不能为空!")
- public String getAddress() {
- return address;
- }
- public void setAddress(String address) {
- this.address = address;
- }
- @Size(max=11,min=11,message="长度只能为11位!")
- public String getPhoneNumber() {
- return phoneNumber;
- }
- public void setPhoneNumber(String phoneNumber) {
- this.phoneNumber = phoneNumber;
- }
- @Email(message="email地址无效!")
- @NotNull(message="email地址不能为空!")
- public String getEmail() {
- return email;
- }
- public void setEmail(String email) {
- this.email = email;
- }
- @NotNull(message = "Model3不能为空!")
- @Valid
- @ManyToOne
- public Model3 getModel3() {
- return model3;
- }
- public void setModel3(Model3 model3) {
- this.model3 = model3;
- }
- @Min(value=18,message="必须年满18岁!")
- @Max(value=30,message="年龄不能大于30岁!")
- public int getAge() {
- return age;
- }
- public void setAge(int age) {
- this.age = age;
- }
- @URL(message="无效的URL地址")
- @NotNull(message = "URL不能为空!")
- public String getUrl() {
- return url;
- }
- public void setUrl(String url) {
- this.url = url;
- }
- }
Model3:
- import javax.persistence.Entity;
- import javax.persistence.GeneratedValue;
- import javax.persistence.Id;
- import javax.persistence.Table;
- import javax.validation.constraints.NotNull;
- @Entity
- @Table(name="t_Model3")
- public class Model3 {
- private int id;
- private String name;
- @Id
- @GeneratedValue
- public int getId() {
- return id;
- }
- public void setId(int id) {
- this.id = id;
- }
- @NotNull(message="model3的名称不能为空!")
- public String getName() {
- return name;
- }
- public void setName(String name) {
- this.name = name;
- }
- }
Test类:
- import org.springframework.context.ApplicationContext;
- import com.tiantian.test.model.Model2;
- import com.tiantian.test.service.Model2Service;
- import com.tiantian.test20110430.util.Util;
- public class Test1 {
- public static void main(String args[]) {
- ApplicationContext context = Util.getContext();
- Model2Service service = context.getBean(Model2Service.class);
- Model2 model = new Model2();
- model.setName("hello");
- model.setEmail("testHibernateValidate@sohu.com");
- model.setAddress("湖南长沙");
- model.setPhoneNumber("15012345678");
- String result = Util.validateModel(model);// 返回的验证结果,验证结果就是一个字符串,如果有错误的话则该字符串的长度大于0
- System.out.println(result);
- if (result.length() == 0)// 验证不通过的时候就不添加
- service.add(model);
- }
- }
上面用到的Util类:
- import java.util.Iterator;
- import java.util.Set;
- import javax.validation.ConstraintViolation;
- import javax.validation.Validation;
- import javax.validation.Validator;
- import org.springframework.context.ApplicationContext;
- import org.springframework.context.support.ClassPathXmlApplicationContext;
- public class Util {
- private static ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");
- public static ApplicationContext getContext() {
- return context;
- }
- public static String validateModel(Object obj) {//验证某一个对象
- StringBuffer buffer = new StringBuffer(64);//用于存储验证后的错误信息
- Validator validator = Validation.buildDefaultValidatorFactory()
- .getValidator();
- Set<ConstraintViolation<Object>> constraintViolations = validator
- .validate(obj);//验证某个对象,,其实也可以只验证其中的某一个属性的
- Iterator<ConstraintViolation<Object>> iter = constraintViolations
- .iterator();
- while (iter.hasNext()) {
- String message = iter.next().getMessage();
- buffer.append(message);
- }
- return buffer.toString();
- }
- }
下面是一些主要的注解:
- @AssertTrue //用于boolean字段,该字段只能为true
- @AssertFalse//该字段的值只能为false
- @CreditCardNumber//对信用卡号进行一个大致的验证
- @DecimalMax//只能小于或等于该值
- @DecimalMin//只能大于或等于该值
- @Digits(integer=2,fraction=20)//检查是否是一种数字的整数、分数,小数位数的数字。
- @Email//检查是否是一个有效的email地址
- @Future//检查该字段的日期是否是属于将来的日期
- @Length(min=,max=)//检查所属的字段的长度是否在min和max之间,只能用于字符串
- @Max//该字段的值只能小于或等于该值
- @Min//该字段的值只能大于或等于该值
- @NotNull//不能为null
- @NotBlank//不能为空,检查时会将空格忽略
- @NotEmpty//不能为空,这里的空是指空字符串
- @Null//检查该字段为空
- @Past//检查该字段的日期是在过去
- @Size(min=, max=)//检查该字段的size是否在min和max之间,可以是字符串、数组、集合、Map等
- @URL(protocol=,host,port)//检查是否是一个有效的URL,如果提供了protocol,host等,则该URL还需满足提供的条件
- @Valid//该注解只要用于字段为一个包含其他对象的集合或map或数组的字段,或该字段直接为一个其他对象的引用,
- //这样在检查当前对象的同时也会检查该字段所引用的对象
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注解即可级联验证 |