Bean 验证内置约束
使用本信息可查找关于 Bean 验证 API 内置约束的信息。
Bean 验证 API 受主要通过注释表达的约束支持。这些约束被添加至 Enterprise JavaBeans (EJB) 组件的类、字段或方法。带有注释的元素值将由约束进行检查。
约束可以是内置约束,也可以是用户定义的约束。javax.validation.constraints 包中提供了多个内置注释。这些注释用于定义常规约束定义,并且用于编写约束。
下表是约束和用法的列表。
约束 | 用法 |
---|---|
@Null | 指定使用此注释装饰的配置属性必须具有空值。此约束接受任何类型。 |
@NotNull | 指定使用此注释装饰的配置属性不得具有空值。也就是说,该属性是必需的。此约束接受任何类型。 |
@AssertTrue | 指定使用此注释装饰的配置属性必须为 true。受支持的值类型为 boolean 和 Boolean。Null 元素被视为有效。 |
@AssertFalse | 指定使用此注释装饰的配置属性必须为 false。受支持的值类型为 boolean 和 Boolean。Null 元素被视为有效。 |
@Min | 指定使用此注释装饰的配置属性的值必须大于或等于指定的最小值。受支持的值类型为 BigDecimal、BigInteger、byte、short、int、long 以及它们各自的包装。Null 元素被视为有效。 |
@Max | 指定使用此注释装饰的配置属性的值必须小于或等于指定的最小值。受支持的值类型为 BigDecimal、BigInteger、byte、short、int、long 以及它们各自的包装。Null 元素被视为有效。 |
@DecimalMin | 指定使用此注释装饰的配置属性的值必须大于或等于指定的最小值。受支持的值类型为 BigDecimal、BigInteger、String、byte、short、int、long 以及它们各自的包装。Null 元素被视为有效。 |
@DecimalMax | 指定使用此注释装饰的配置属性的值必须小于或等于指定的最小值。受支持的值类型为 BigDecimal、BigInteger、String、byte、short、int、long 以及它们各自的包装。Null 元素被视为有效。 |
@Size | 指定使用此注释装饰的配置属性的值必须介于指定的边界之间(含边界)。受支持的值类型为 String(将对字符串长度进行求值)、Collection(将对集合大小进行求值)、Map(将对映射大小进行求值)和 Array(将对数组长度进行求值)。Null 元素被视为有效。 |
@Digits | 指定使用此注释装饰的配置属性的值必须位于接受范围内。受支持的值类型为 BigDecimal、BigInteger、String、byte、short、int、long 以及它们各自的包装。Null 元素被视为有效。 |
@Past | 指定使用此注释装饰的配置属性必须具有过去某个日期。已根据虚拟机将“现在”定义为当前时间。如果所比较的类型属于 Calendar 类型,那么将使用日历,并且日历基于当前时区和当前语言环境。受支持的值类型为 java.util.Date 和 java.util.Calendar。Null 元素被视为有效。 |
@Future | 指定使用此注释装饰的配置属性必须具有将来某个日期。已根据虚拟机将“现在”定义为当前时间。如果所比较的类型属于 Calendar 类型,那么将使用日历,并且日历基于当前时区和当前语言环境。受支持的值类型为 java.util.Date 和 java.util.Calendar。Null 元素被视为有效。 |
@Pattern | 指定使用此注释装饰的配置属性必须与以下正则表达式相匹配。该正则表达式遵循 Java™ 正则表达式约定 java.util.regex.Pattern。受支持的类型值为 String。Null 元素被视为有效。 |