Hibernate validator使用和自定义validator及整合Spring MVC

Hibernate validator使用

导入validation-api-xxx.jar 以及 hibernate-validator-xxx.Final.jar

需要检查的java bean

Entity.java

import javax.validation.constraints.Max;
import org.hibernate.validator.constraints.Length;
public class Entity {
@Max(value= 3) //最大值为3
private int age;
@Length(max= 1) //字符串长度最大为1,hibernate 扩展的
private String name;
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}

值校验的测试类

import java.util.Set;
import javax.validation.ConstraintViolation;
import javax.validation.Validation;
import javax.validation.Validator;
import javax.validation.ValidatorFactory;
public class Tv {
public static void main(String[] args) {
ValidatorFactory factory = Validation.buildDefaultValidatorFactory();
Validator validator = factory.getValidator();
Entity entity = new Entity();
entity.setAge( 12);
entity.setName( "admin");
Set<ConstraintViolation<Entity>> constraintViolations = validator.validate(entity);
for (ConstraintViolation<Entity> constraintViolation : constraintViolations) {
System.out.println( "对象属性:"+constraintViolation.getPropertyPath());
System.out.println( "国际化key:"+constraintViolation.getMessageTemplate());
System.out.println( "错误信息:"+constraintViolation.getMessage());
}
}
}

输出结果

这里有一个国际化的key值,国际化文件在org.hibernate.validator下面的一系列的properites文件里面,如果需要自定义那么可以拷贝出来放在src目录下

这里我们拷贝一个出来,新增一个key为maxlength=字符串长度最大不能超过{max} ,可以使用动态参数,这里的max值就是注解里面设定的值

然后修改Entity.java,name属性的message="{maxlength}"

@Length(max= 1,message= "{maxlength}") //{maxlength}对应配置文件中的key. 必须有{}
private String name;

再次运行结果如下

自定义validator

首先自定义一个注解CannotContainSpaces (不能包含空格)

import java.lang.annotation.Documented;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;
import javax.validation.Constraint;
import javax.validation.Payload;
@Constraint(validatedBy = CannotContainSpacesValidator.class) //具体的实现
@Target( { java.lang.annotation.ElementType.METHOD,
java.lang.annotation.ElementType.FIELD })
@Retention(java.lang.annotation.RetentionPolicy.RUNTIME)
@Documented
public @interface CannotContainSpaces {
String message() default "{Cannot.contain.Spaces} "; //提示信息,可以写死,可以填写国际化的key
int length() default 5;
//下面这两个属性必须添加
Class<?>[] groups() default {};
Class<? extends Payload>[] payload() default {};
}

具体实现类CannotContainSpacesValidator.java

import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;
public class CannotContainSpacesValidator implements ConstraintValidator<CannotContainSpaces, String> {
private int len;
/**
* 初始参数,获取注解中length的值
*/
@Override
public void initialize(CannotContainSpaces arg0) {
this.len = arg0.length();
}
@Override
public boolean isValid(String str, ConstraintValidatorContext constraintValidatorContext) {
if(str != null){
if(str.indexOf( " ") < 0){
return true;
}
} else{
constraintValidatorContext.disableDefaultConstraintViolation(); //禁用默认的message的值
//重新添加错误提示语句
constraintValidatorContext
.buildConstraintViolationWithTemplate( "字符串不能为空").addConstraintViolation();
}
return false;
}
}

使用的时候直接注解到对象的属性上面就可以了

@CannotContainSpaces
private String name;

测试当name包含空格的时候 entity.setName("xx xx");

当name为null的时候

整合Spring MVC

首先新增配置文件内容(实体类里面的注解与上面完全相同)

<bean id="localeResolver"
class= "org.springframework.web.servlet.i18n.CookieLocaleResolver" />
<bean id="messageSource"
class= "org.springframework.context.support.ReloadableResourceBundleMessageSource">
<property name="basenames">
<list>
<value>classpath:messages/messages </value>
<value>classpath:messages/Validation </value>
</list>
</property>
<property name="useCodeAsDefaultMessage" value="true" />
</bean>
<mvc:annotation-driven validator="validator" />
<bean id="validator" class="org.springframework.validation.beanvalidation.LocalValidatorFactoryBean">
<property name="providerClass" value="org.hibernate.validator.HibernateValidator"/>
<property name="validationMessageSource" ref="messageSource"/>
</bean>

在Spring MVC 控制器中方法属性如下

/**
* 这里的@Valid必须书写, bindingResult参数也必须书写在后面,否则验证不通过就会返回400
* @param entity
* @param result
* @return
*/
@RequestMapping(value= "/valid")
public String validator(@Valid Entity entity,BindingResult result){
if(result.hasErrors()){
//如果严重没有通过,跳转提示
return "error";
} else{
//继续业务逻辑
}
return "success";
}

error.jsp中如下

导入spring标签库

<%@ taglib uri="http://www.springframework.org/tags/form" prefix="form"%>

<form:form commandName="entity">
<form:errors path="*"/>
</form:form>
<hr/>
<form:errors path="entity.name"/>

校验注解说明

Bean Validation 中内置的 constraint   
@Null   被注释的元素必须为 null   
@NotNull    被注释的元素必须不为 null   
@AssertTrue     被注释的元素必须为 true   
@AssertFalse    被注释的元素必须为 false   
@Min(value)     被注释的元素必须是一个数字，其值必须大于等于指定的最小值   
@Max(value)     被注释的元素必须是一个数字，其值必须小于等于指定的最大值   
@DecimalMin(value)  被注释的元素必须是一个数字，其值必须大于等于指定的最小值   
@DecimalMax(value)  被注释的元素必须是一个数字，其值必须小于等于指定的最大值   
@Size(max=, min=)   被注释的元素的大小必须在指定的范围内   
@Digits (integer, fraction)     被注释的元素必须是一个数字，其值必须在可接受的范围内   
@Past   被注释的元素必须是一个过去的日期   
@Future     被注释的元素必须是一个将来的日期   
@Pattern(regex=,flag=)  被注释的元素必须符合指定的正则表达式   
Hibernate Validator 附加的 constraint   
@NotBlank(message =)   验证字符串非null，且长度必须大于0   
@Email  被注释的元素必须是电子邮箱地址   
@Length(min=,max=)  被注释的字符串的大小必须在指定的范围内   
@NotEmpty   被注释的字符串的必须非空   
@Range(min=,max=,message=)  被注释的元素必须在合适的范围内

注意

①:在整合Spring MVC的时候,ValidationMessages_zh_CN.properties文件如果不是放在src目录下(如上面放在src/messages/下面) 那么在属性文件里面不能使用动态参数获取了(如${length} ${max}这些). 必须将hibernate validation的国际化属性全部放到src目录下面才可以(不晓得为什么,如果你能解决顺便留个言)

②:我这里使用的是spring 4.1 + hibernate validation 5.1 ,如果你使用的是spring 3.2 需要对于的hibernate validation版本是 4.x的不然在配置

org.springframework.validation.beanvalidation.LocalValidatorFactoryBean

这个的是会报错,