JSR303 注解的校验类型

1. 空检查

• @Null 验证对象是否为null

• @NotNull 验证对象是否不为null, 无法查检长度为0的字符串

• @NotBlank 检查约束字符串是不是Null还有被Trim的长度是否大于0,只对字符串,且会去掉前后空格.

• @NotEmpty 检查约束元素是否为NULL或者是EMPTY.

2. Booelan检查

• @AssertTrue 验证 Boolean 对象是否为 true

• @AssertFalse 验证 Boolean 对象是否为 false

3. 长度检查

• @Size(min=, max=) 验证对象（Array,Collection,Map,String）长度是否在给定的范围之内

• @Length(min=, max=) Validates that the annotated string is between min and max included.

4.日期检查

• @Past 验证 Date 和 Calendar 对象是否在当前时间之前

• @Future 验证 Date 和 Calendar 对象是否在当前时间之后

• @Pattern 验证 String 对象是否符合正则表达式的规则

5. 数值检查

建议使用在Stirng,Integer类型，不建议使用在int类型上，因为表单值为“”时无法转换为int，但可以转换为Stirng为"",Integer为null

• @Min 验证 Number 和 String 对象是否大等于指定的值

• @Max 验证 Number 和 String 对象是否小等于指定的值

• @DecimalMax 被标注的值必须不大于约束中指定的最大值. 这个约束的参数是一个通过BigDecimal定义的最大值的字符串表示.小数存在精度

• @DecimalMin 被标注的值必须不小于约束中指定的最小值. 这个约束的参数是一个通过BigDecimal定义的最小值的字符串表示.小数存在精度

• @Digits 验证 Number 和 String 的构成是否合法

• @Digits(integer=,fraction=) 验证字符串是否是符合指定格式的数字，interger指定整数精度，fraction指定小数精度。

• @Range(min=, max=) 检查数字是否介于min和max之间.

6. 参数个性化校验

• @ScriptAssert(lang= ,script=, alias=)，作用在类上的校验

  以用户注册为例。在用户注册时我们要校验输入密码与确认密码是否一致，和用户名中是否包含特殊字符

  @ScriptAssert(script = "_this.password.equals(_this.rePassword)",lang = "javascript",message = "确认密码与输入密码不一致")
  

  1. _this是默认的对象别名，lang="javascript" 表示用java 执行script中的脚本；
2. script指定特定的静态方法校验用户名是否包含特殊字符。

  @ScriptAssert(script = "com.banyejiu.system.vo.RegisterUserVO.checkUsername(_this.username)",lang = "javascript",message = "用户名不能包含! @ # $ % & * \\ / ? ？特殊符号")
  public class RegisterUserVO{
  	private String username;
  }
  public static boolean checkUsername(String username){
      String[] chars = {"!","@","#","$","%","&","*","\\","/","?","？"};
      for(String c : chars){
          if(username.contains(c)){
              return false;
          }
      }
      return true;
  }
  

  注意script中方法是一个静态的方法，且包含完整的调用路径。校验参数时，会调用CheckUsername这个静态方法，方法参数为这个对象的username属性。

  多个ScriptAssert需要使用@ScriptAssert.List

  @ScriptAssert.List({
  	@ScriptAssert(),
  	@ScriptAssert()
  })
  

7. 其他校验

• @Valid 递归的对关联对象进行校验, 如果关联对象是个集合或者数组,那么对其中的元素进行递归校验,如果是一个map,则对其中的值部分进行校验.(是否进行递归验证)

• @Email 验证是否是邮件地址，如果为null,不进行验证，算通过验证。

• @URL(protocol=,host=, port=,regexp=, flags=)