在项目开发过程中,后台在很多场景都需要进行校验操作,比如:前台表单提交到后台,系统接口调用,数据传输等等。而且很多项目都采用MVC分层式设计,每层还有需要进行相应地校验,这样在项目较大,多人协作开发的时候,会造成大量重复校验代码,且出错率高。
针对这个问题,JCP出台一个JSR 303-Bean Validation规范,而Hibernate Validator 作为Bean Validation的参考实现,提供了JSR 303规范中所有内置constraint的实现,除此之外还有一些附加的constraint。
Hibernate Validation的使用非常简单,只用在相应的实体类中加上注解,再调用对应的校验API方法即可。
Hibernate Validation目前最新的稳定版本是:5.1.3。下载地址
官网地址
官方英文使用手册
官方中文使用手册地址(中文版目前最新的是4.3版本)
具体使用方法请查看上面的官方使用手册地址,每个注解对应的含义在官方手册2.4章节有详细介绍,内容太多我就不贴过来了。下面直接上最常用情况(实体类校验)的示例代码。
一、依赖包
J2SE环境下除了需要引入Hibernate Validation包外,还需要额外引入两个实现表达式语言的包。J2EE环境如果容器提供不需要再引入。下面是J2SE环境下的依赖包:
<dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate-validator</artifactId> <version>5.1.3.Final</version> </dependency> <dependency> <groupId>javax.el</groupId> <artifactId>javax.el-api</artifactId> <version>2.2.4</version> </dependency> <dependency> <groupId>org.glassfish.web</groupId> <artifactId>javax.el</artifactId> <version>2.2.4</version> </dependency>
二、校验工具类
工具类提供了校验实体类、实体字段的方法,返回一个自定义的校验对象。
/** * 校验工具类 * @author wdmcygah * */ public class ValidationUtils { private static Validator validator = Validation.buildDefaultValidatorFactory().getValidator(); public static <T> ValidationResult validateEntity(T obj){ ValidationResult result = new ValidationResult(); Set<ConstraintViolation<T>> set = validator.validate(obj,Default.class); if( CollectionUtils.isNotEmpty(set) ){ result.setHasErrors(true); Map<String,String> errorMsg = new HashMap<String,String>(); for(ConstraintViolation<T> cv : set){ errorMsg.put(cv.getPropertyPath().toString(), cv.getMessage()); } result.setErrorMsg(errorMsg); } return result; } public static <T> ValidationResult validateProperty(T obj,String propertyName){ ValidationResult result = new ValidationResult(); Set<ConstraintViolation<T>> set = validator.validateProperty(obj,propertyName,Default.class); if( CollectionUtils.isNotEmpty(set) ){ result.setHasErrors(true); Map<String,String> errorMsg = new HashMap<String,String>(); for(ConstraintViolation<T> cv : set){ errorMsg.put(propertyName, cv.getMessage()); } result.setErrorMsg(errorMsg); } return result; } }
三、校验返回对象
/**
* 校验结果
* @author wdmcygah
*
*/
public class ValidationResult {
//校验结果是否有错
private boolean hasErrors;
//校验错误信息
private Map<String,String> errorMsg;
public boolean isHasErrors() {
return hasErrors;
}
public void setHasErrors(boolean hasErrors) {
this.hasErrors = hasErrors;
}
public Map<String, String> getErrorMsg() {
return errorMsg;
}
public void setErrorMsg(Map<String, String> errorMsg) {
this.errorMsg = errorMsg;
}
@Override
public String toString() {
return "ValidationResult [hasErrors=" + hasErrors + ", errorMsg="
+ errorMsg + "]";
}
}
四、被校验实体
public class SimpleEntity { @NotBlank(message="名字不能为空或者空串") @Length(min=2,max=10,message="名字必须由2~10个字组成") private String name; @Past(message="时间不能晚于当前时间") private Date date; @Email(message="邮箱格式不正确") private String email; @Pattern(regexp="(?![0-9]+$)(?![a-zA-Z]+$)[0-9A-Za-z]{5,10}",message="密码必须是5~10位数字和字母的组合") private String password; @AssertTrue(message="字段必须为真") private boolean valid; //get set方法省略,自己添加 }
有些情况下,Hibernate Validation自带的注解不能够满足需求,我们想定制一个注解进行使用,此时可以参考下面的示例(自定义密码注解及校验规则)。
一、密码注解
package research.hibernate.validation.extend; import static java.lang.annotation.ElementType.ANNOTATION_TYPE; import static java.lang.annotation.ElementType.FIELD; import static java.lang.annotation.ElementType.METHOD; import static java.lang.annotation.RetentionPolicy.RUNTIME; import java.lang.annotation.Documented; import java.lang.annotation.Retention; import java.lang.annotation.Target; import javax.validation.Constraint; import javax.validation.Payload; @Target( { METHOD, FIELD, ANNOTATION_TYPE }) @Retention(RUNTIME) @Constraint(validatedBy = PasswordValidator.class) @Documented public @interface Password { String message() default "{密码必须是5~10位数字和字母组合}"; Class<?>[] groups() default {}; Class<? extends Payload>[] payload() default {}; }
二、密码校验类
/** * 自定义密码校验类 * @author wdmcygah * */ public class PasswordValidator implements ConstraintValidator<Password, String> { //5~10位的数字与字母组合 private static Pattern pattern = Pattern.compile("(?![0-9]+$)(?![a-zA-Z]+$)[0-9A-Za-z]{5,10}"); public void initialize(Password constraintAnnotation) { //do nothing } public boolean isValid(String value, ConstraintValidatorContext context) { if( value==null ){ return false; } Matcher m = pattern.matcher(value); return m.matches(); } }
三、被校验实体
public class ExtendEntity { @Password private String password; public String getPassword() { return password; } public void setPassword(String password) { this.password = password; } }
对应的测试类如下:
public class ValidationUtilsTest extends TestCase{ public void validateSimpleEntity() { SimpleEntity se = new SimpleEntity(); se.setDate(new Date()); se.setEmail("123"); se.setName("123"); se.setPassword("123"); se.setValid(false); ValidationResult result = ValidationUtils.validateEntity(se); System.out.println("--------------------------"); System.out.println(result); Assert.assertTrue(result.isHasErrors()); } public void validateSimpleProperty() { SimpleEntity se = new SimpleEntity(); ValidationResult result = ValidationUtils.validateProperty(se,"name"); System.out.println("--------------------------"); System.out.println(result); Assert.assertTrue(result.isHasErrors()); } public void validateExtendEntity() { ExtendEntity ee = new ExtendEntity(); ee.setPassword("212"); ValidationResult result = ValidationUtils.validateEntity(ee); System.out.println("--------------------------"); System.out.println(result); Assert.assertTrue(result.isHasErrors()); } }
代码在JDK1.8下测试通过。完整代码可查看我的Github仓库:https://github.com/wdmcygah/research-J2SE
备注:
(1)上述示例只是展示了Hibernate Validation比较常用的示例,框架其实还支持方法返回值、方法参数校验,另外也可以通过XML进行配置,校验还可以分组、合并等等。这些内容请查阅官方使用手册。
(2)另外还有一个也还不错的校验框架:OVAL。OVAL源码地址
相关推荐
文档列举了引用 Hibernate Validation各注解的用法,完成对实体约束验证的配置。
Hibernate对Bean Validation规范的实现文档
Bean Validation 规范对 Java Bean 的验证流程如下:在实际使用中调用 Validator.validate(JavaBeanInstance) 方法后,Bean Validation 会查找在 JavaBeanInstance上所有的约束声明,对每一个约束调用对应的约束验证...
NULL 博文链接:https://wdmcygah.iteye.com/blog/2174538
resin 支持spring mvc 5.0以上版本 支持Hibernate validation 下载使用即可版本为 resin-4.0.61
Hibernate Validator 是 Bean Validation 的参考实现 . Hibernate Validator 提供了 JSR 303 规范中所有内置 constraint 的实现,下面这篇文章主要给大家介绍了关于如何自定义hibernate validation注解的相关资料,...
与springmvc4完美兼容的validation jar包集合,让程序员更加轻松的进行编程
ssm框架validator应用jia包3个 hibernate-validator-5.0.1 jboss-logging-3.3.0 validation-api-1.0.0
springMVC整合hibernate的校验Validation, 简单明了。
主要介绍了JAVA中通过Hibernate-Validation进行参数验证,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
主要介绍了Hibernate Validation自定义注解校验的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
Springboot SpringMVC thymeleaf页面提交Validation实现实例.pdfSpringboot SpringMVC thymeleaf页面提交Validation实现实例.pdfSpringboot SpringMVC thymeleaf页面提交Validation实现实例.pdfSpringboot SpringMVC...
里面含有hibernate-validator 进行校验的jar包,包括了基础hibernate-validator-5.0.0.CR2.jar hibernate-validator-annotation-processor-5.0.0.CR2.jar
使用FormValidation进行表单验证,使用到了jQuery和Bootstrap框架等相关技术
使用springmvc中validation验证的两个jar包! hibernate-validator-5.2.2.Final.jar和validation-api-1.1.0.Final.jar!
Bean Validation示例代码,简单的使用, 参考博客:http://blog.csdn.net/yuguiyang1990/article/details/10362795
Springboot SpringMVC thymeleaf页面提交Validation实现实例.docxSpringboot SpringMVC thymeleaf页面提交Validation实现实例.docxSpringboot SpringMVC thymeleaf页面提交Validation实现实例.docxSpringboot ...
springmvc,hibernate的校验框架validation所需要的jar包,hibernate-validator-5.0.0.CR2.jar