在日常开发中,Hibernate Validator经常用来验证bean的字段,基于注解,方便快捷高效。

1. Bean Validation 中内置的 constraint

           注解                                      作用

 



@Valid

被注释的元素是一个对象,需要检查此对象的所有字段值

@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(value)

被注释的元素必须符合指定的正则表达式



2. Hibernate Validator 附加的 constraint



注解

作用

@Email

被注释的元素必须是电子邮箱地址

@Length(min=, max=)

被注释的字符串的大小必须在指定的范围内

@NotEmpty

被注释的字符串的必须非空

@Range(min=, max=)

被注释的元素必须在合适的范围内



@NotBlank

被注释的字符串的必须非空

@URL(protocol=,

host=,    port=, 

regexp=, flags=)

被注释的字符串必须是一个有效的url



@CreditCardNumber

被注释的字符串必须通过Luhn校验算法,

银行卡,信用卡等号码一般都用Luhn

计算合法性

@ScriptAssert

(lang=, script=, alias=)

要有Java Scripting API 即JSR 223 

("Scripting for the JavaTM Platform")的实现

@SafeHtml

(whitelistType=, 

additionalTags=)

classpath中要有jsoup包



hibernate补充的注解中,最后3个不常用,可忽略。

 

主要区分下@NotNull  @NotEmpty  @NotBlank 3个注解的区别:

@NotNull           任何对象的value不能为null

@NotEmpty       集合对象的元素不为0,即集合不为空,也可以用于字符串不为null

@NotBlank        只能用于字符串不为null,并且字符串trim()以后length要大于0

举个使用的例子:

 

  1.  
    public class User {
  2.    
  3.  
    @NotBlank
  4.  
    private String name;
  5.    
  6.  
    //年龄要大于18岁
  7.  
    @Min(18)
  8.  
    private int age;
  9.    
  10.  
    @Email
  11.  
    private String email;
  12.    
  13.  
    //嵌套验证
  14.  
    @Valid
  15.  
    private Product products;
  16.    
  17.  
    //省略getter,setter
  18.  
    }
  19.    
  20.  
    public class Product {
  21.    
  22.  
    @NotBlank
  23.  
    private String name;
  24.    
  25.  
    //价格在10元-50元之间
  26.  
    @Range(min=10,max=50)
  27.  
    private int price;
  28.    
  29.  
    //省略getter,setter
  30.  
    }

本人当时测试引入的依赖为:

 

  1.  
    <dependency>
  2.  
    <groupId>org.hibernate</groupId>
  3.  
    <artifactId>hibernate-validator</artifactId>
  4.  
    <version>5.3.4.Final</version>
  5.  
    </dependency>
  6.  
    <dependency>
  7.  
    <groupId>javax.el</groupId>
  8.  
    <artifactId>javax.el-api</artifactId>
  9.  
    <version>2.2.4</version>
  10.  
    </dependency>
  11.  
    <dependency>
  12.  
    <groupId>org.glassfish.web</groupId>
  13.  
    <artifactId>javax.el</artifactId>
  14.  
    <version>2.2.4</version>
  15.  
    </dependency>
  16.