65.2.2. 标准注解

Bean 验证限制

表 65.1 “Bean 验证的标准注释” 显示 Bean Validation 规范中定义的标准注释,它们可用于定义字段和方法返回值和参数(标准注解没有可以在类级别上应用)。

表 65.1. Bean 验证的标准注释

注解适用于描述

@AssertFalse

布尔值,布尔值

检查注解的元素是否为 false

@AssertTrue

布尔值,布尔值

检查注解的元素是否为 true

@DecimalMax(value=, inclusive=)

BigDecimal,BigInteger,CharSequence, byte, short, int ,int,long 和 primitive type wrappers

inclusive=false 时,检查注解的值是否小于指定的最大值。否则,检查该值是否小于或等于指定的最大值。value 参数指定最大为 BigDecimal 字符串格式。

@DecimalMin(value=, inclusive=)

BigDecimal,BigInteger,CharSequence, byte, short, int ,int,long 和 primitive type wrappers

inclusive=false 时,检查注解的值是否大于指定最小值。否则,检查值是否大于或等于指定最小值。value 参数指定最小值,采用 BigDecimal 字符串格式。

@Digits(integer=, fraction=)

BigDecimal,BigInteger,CharSequence, byte, short, int ,int,long 和 primitive type wrappers

检查注释的值是否为具有最多 整数 数和 部分 部分数字的数字。

@Future

java.util.Date, java.util.Calendar

检查注解日期是否在将来。

@Max(value=)

BigDecimal,BigInteger,CharSequence, byte, short, int ,int,long 和 primitive type wrappers

检查注解的值是否小于或等于指定的最大值。

@Min(value=)

BigDecimal,BigInteger,CharSequence, byte, short, int ,int,long 和 primitive type wrappers

检查注解的值是否大于或等于指定最小值。

@NotNull

任何类型

检查注释的值不是 null

@Null

任何类型

检查注释的值是否为 null

@Past

java.util.Date, java.util.Calendar

检查注解的日期是否位于过去。

@Pattern(regex=, flag=)

CharSequence

检查注释的字符串 是否与 正则表达式正则表达式匹配。

@Size(min=, max=)

CharSequence,Collection,Map and 数组

检查注解的集合、映射或数组的大小(包括在 minmax (含)之间。

@Valid

任何非保护类型

在注释的对象上递归执行验证。如果对象是集合或数组,则会以递归方式验证元素。如果对象是映射映射,则将递归验证值元素。