Bean 驗證內建限制
使用此資訊來查閱「Bean 驗證」API 內建限制的相關資訊。
「Bean 驗證」API 由主要透過註釋所表達的限制提供支援。 這些限制可加入至 Enterprise JavaBeans (EJB) 元件的類別、欄位或方法中。 標註的元素值由限制來檢查。
限制可以是內建,或由使用者定義。 javax.validation.constraints 套件中提供數個內建註釋。這些註釋用來定義一般限制定義及編寫限制。
下表是限制和用法的清單。
限制 | 用法 |
---|---|
@Null | 指定以這個註釋來裝飾的配置內容必須是空值。此限制接受任何類型。 |
@NotNull | 指定以這個註釋來裝飾的配置內容不得為空值。亦即,這是必要內容。此限制接受任何類型。 |
@AssertTrue | 指定以這個註釋來裝飾的配置內容必須為 true。支援的值類型為布林和 Boolean。空值元素視為有效。 |
@AssertFalse | 指定以這個註釋來裝飾的配置內容必須為 false。支援的值類型為布林和 Boolean。空值元素視為有效。 |
@Min | 指定以這個註釋來裝飾的配置內容的值必須大於或等於指定的下限。支援的值類型包括 BigDecimal、BigInteger、byte、short、int、long 及其個別的包裝函數。空值元素視為有效。 |
@Max | 指定以這個註釋來裝飾的配置內容的值必須小於或等於指定的上限。支援的值類型包括 BigDecimal、BigInteger、byte、short、int、long 及其個別的包裝函數。空值元素視為有效。 |
@DecimalMin | 指定以這個註釋來裝飾的配置內容的值必須高於或等於指定的下限。支援的值類型包括 BigDecimal、BigInteger、String、byte、short、int、long 及其個別的包裝函數。空值元素視為有效。 |
@DecimalMax | 指定以這個註釋來裝飾的配置內容的值必須低於或等於指定的上限。支援的值類型包括 BigDecimal、BigInteger、String、byte、short、int、long 及其個別的包裝函數。空值元素視為有效。 |
@Size | 指定以這個註釋來裝飾的配置內容的值必須介於指定的界限之間(含)。支援的值類型為 String(評估字串長度)、Collection(評估集合大小)、Map(評估對映大小)、Array(評估陣列長度)。空值元素視為有效。 |
@Digits | 指定以這個註釋來裝飾的配置內容的值必須在接受的範圍內。支援的值類型包括 BigDecimal、BigInteger、String、byte、short、int、long 及其個別的包裝函數。空值元素視為有效。 |
@Past | 指定以這個註釋來裝飾的配置內容的日期必須是在過去。「此刻」定義為虛擬機器上的現行時間。如果比較的類型是 Calendar 類型,則會使用行事曆,而行事曆是根據現行時區和現行語言環境。 支援的值類型為 java.util.Date、java.util.Calendar。空值元素視為有效。 |
@Future | 指定以這個註釋來裝飾的配置內容的日期必須是在未來。「此刻」定義為虛擬機器上的現行時間。如果比較的類型是 Calendar 類型,則會使用行事曆,而行事曆是根據現行時區和現行語言環境。 支援的值類型為 java.util.Date、java.util.Calendar。空值元素視為有效。 |
@Pattern | 指定以這個註釋來裝飾的配置內容必須符合緊接的正規表示式。正規表示式遵循 Java™ 正規表示式慣例 java.util.regex.Pattern。支援的類型值為 String。空值元素視為有效。 |