每周分享之《JSR303 Bean Validation介绍以及在项目中的使用》

项目中参数校验，用到JSR 303，在此总结梳理下知识脉络，抛砖引玉。

一、基础

1.What is JSR?

　　JSR是Java Specification Requests的缩写，意思是Java 规范提案。任何人都可以提交JSR，以向Java平台增添新的API和服务。JSR已成为Java界的一个重要标准。

2.Why use JSR 303?

　　问题：在通常的情况下，应用程序是分层的，不同的层由不同的开发人员来完成。很多时候同样的数据验证逻辑会出现在不同的层，这样耗时且容易出错，导致代码冗余和一些管理的问题。

　　想法：为了避免这样的情况发生，最好是将验证逻辑与相应的域模型进行绑定。（开发者更倾向于将验证规则直接放到 Java Bean 本身，使用注解的方式进行验证规则的设计。）　　

　　解决方案：Bean Validation为JavaBean 验证定义了相应的元数据模型（注解）和 API，它是一个运行时的数据验证框架，来使用其定义的验证检查JavaBean属性值，在验证之后验证的错误信息会被马上返回（Hibernate Validator 是 Bean Validation 的参考实现，提供了 JSR 303 规范中所有内置 constraint 的实现，除此之外还有一些附加的 constraint）。

3.常用

·空检查

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

　　@NotEmpty 检查约束元素（String类、Collection、Map、数组）是否为NULL或者是EMPTY(实际意义等同于 @NotNull 和 @Size(min=1)的组合)

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

·长度检查

　　@Length(max, min) Validates that the annotated 字符串 is between min and max included.

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

·数字大小

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

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

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

　　@DecimalMin 验证 Number 和 String 对象是否大等于指定的值，这个约束的参数是一个通过BigDecimal定义的最小值的字符串表示，小数存在精度

　　@DecimalMax 验证 Number 和 String 对象是否小等于指定的值，这个约束的参数是一个通过BigDecimal定义的最大值的字符串表示，小数存在精度

注：上述注解具体对象为 BigDecimal，BigInteger, byte,short, int, long等任何Number或CharSequence（存储的是数字）子类型。

·小数精度

　　@Digits (integer, fraction) 验证 Number 和 String 的构成是否合法(符合指定格式的数字)，integer是整数精度（整数位数上限），fraction是小数精度（小数位数上限）

4.constraint （约束）

　　通常由 annotation 和相应的 constraint validator 组成，它们是一对多的关系。在运行时，Bean Validation 框架本身会根据被注释元素的类型来选择合适的 constraint validator 对数据进行验证。（自己也可使用内置的constraint定制化所需constraint，或者新开发constraint — 继承ConstraintValidator）