一、什么是JSR-303?
JSR-303 是 JAVA EE 6 中的一项子规范,叫做 Bean Validation,官方参考实现是Hibernate Validator
简单的说,JSR-303就是用来做表单验证的。比如你想检查前端表单输入不为空,就可以在实体类对应的属性上使用JSR-303的@NotNull注解来实现。
JSR 303 用于对 Java Bean 中的字段的值进行验证。 Spring MVC之中也大力支持 JSR-303,可以在控制器中对表单提交的数据方便地验证。 注:可以使用注解的方式进行验证规则的添加。
二、JSR 303提供的校验注解
@Null 必须为 null
@NotNull 必须不为 null,无法检查出长度为0的字符串
@AssertTrue 必须为 true
@AssertFalse 必须为 false
@Min(value) 必须是一个数字,其值必须大于等于指定的最小值
@Max(value) 必须是一个数字,其值必须小于等于指定的最大值
@DecimalMin(value) 必须是一个数字,其值必须大于等于指定的最小值
@DecimalMax(value) 必须是一个数字,其值必须小于等于指定的最大值
@Size(max=, min=) 大小(或长度)必须在指定的范围内 (Array,Collection,Map,String)
@Digits(integer=,fraction=) 验证字符串是否是符合指定格式的数字,interger指定整数精度,fraction指定小数精度。
@Past 必须是一个过去的日期
@Future 必须是一个将来的日期
三、Hibernate Validator提供的校验注解
@NotBlank(message =) 验证字符串非null,且长度必须大于0 ,会自动去掉前后空格
@Email 必须是电子邮箱地址
@NotEmpty 被注解的字符串必须非空, CharSequence,Collection, Map 和 Array 对象不能是 null 并且相关对象的 size 大于 0,用在集合类上面
@Length(min=,max=) 字符串的大小必须在指定的范围内
@Range(min=,max=,message=) 必须在合适的范围内 @SafeHtml 检查富文本中是否包含恶意代码,比如嵌入的script
@UniqueElements检查集合中是否有重复的成员
前三个现在在JSR303中也已经提供。
四、具体使用
1、导入依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-validation</artifactId>
</dependency>
2、在实体类上添加验证规则
@Entity
public class Role {
@Id
@GeneratedValue
private int roleId;
@NotBlank(message="角色不能为空!")
private String roleName;
//message属性如果不加,会使用默认的错误提示。