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。

@Past

java.util.Date, java.util.Calendar

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

@Pattern(regex=, flag=)

CharSequence

检查被注释的字符串是否与给定标记匹配的正则表达式正则表达式匹配。

@Size(min=, max=)

CharSequence、集合、映射 和数组

检查被注解的集合、映射或数组的大小（包括）是否位于 min 和 max （含）之间。

@Valid

任何非primitive 类型

在注解对象中递归执行验证。如果对象是集合或数组，则会以递归方式验证元素。如果对象是一个映射，则值元素会递归验证。