Bean 验证内置约束

使用本信息可查找关于 Bean 验证 API 内置约束的信息。

Bean 验证 API 受主要通过注释表达的约束支持。这些约束被添加至 Enterprise JavaBeans (EJB) 组件的类、字段或方法。带有注释的元素值将由约束进行检查。

约束可以是内置约束,也可以是用户定义的约束。javax.validation.constraints 包中提供了多个内置注释。这些注释用于定义常规约束定义,并且用于编写约束。

下表是约束和用法的列表。

表 1. Bean 验证内置约束. 使用 Bean 验证内置约束
约束 用法
@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 元素被视为有效。

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rdat_beanvalconstraints
文件名:rdat_beanvalconstraints.html