javax.validation.constraints注解使用

更新時(shí)間：2024年07月03日 16:40:46 作者：霽月清風(fēng)與誰(shuí)同

這篇文章主要介紹了javax.validation.constraints注解使用方式,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教

javax.validation.constraints注解

javax.validation.constraints是Java Validation API中的一個(gè)包，它提供了一組注解，用于在Java代碼中進(jìn)行數(shù)據(jù)校驗(yàn)和驗(yàn)證。

該包中定義了多個(gè)注解，用于標(biāo)記屬性或方法參數(shù)的驗(yàn)證規(guī)則。

開(kāi)發(fā)者可以通過(guò)在對(duì)象的屬性上添加這些注解，來(lái)定義相應(yīng)的驗(yàn)證規(guī)則。

常用的注解

@NotNull：用于標(biāo)記屬性或方法參數(shù)不能為null。

適用于任何類(lèi)型的屬性或方法參數(shù)。
不能用于基本數(shù)據(jù)類(lèi)型，因?yàn)樗鼈儾唤邮躰ull值。

@NotEmpty：

用于標(biāo)記字符串、集合、Map等類(lèi)型的屬性或方法參數(shù)不能為null且不能為空。
適用于String、Collection、Map和數(shù)組類(lèi)型的屬性或方法參數(shù)。

@NotBlank：

用于標(biāo)記字符串類(lèi)型的屬性或方法參數(shù)不能為null且包含至少一個(gè)非空格字符。
適用于String類(lèi)型的屬性或方法參數(shù)。

@Min：

用于標(biāo)記數(shù)值類(lèi)型的屬性或方法參數(shù)的最小值。
適用于byte、short、int、long和對(duì)應(yīng)的包裝類(lèi)類(lèi)型的屬性或方法參數(shù)。

@Max：

用于標(biāo)記數(shù)值類(lèi)型的屬性或方法參數(shù)的最大值。
適用于byte、short、int、long和對(duì)應(yīng)的包裝類(lèi)類(lèi)型的屬性或方法參數(shù)。

@Size：

用于標(biāo)記字符串、集合、Map等類(lèi)型的屬性或方法參數(shù)的大小范圍。
可以用于String、Collection、Map和數(shù)組類(lèi)型的屬性或方法參數(shù)。
必須指定大小范圍，例如@Size(min=2, max=10)。

@Pattern：

用于標(biāo)記字符串類(lèi)型的屬性或方法參數(shù)的正則表達(dá)式驗(yàn)證規(guī)則。
適用于String類(lèi)型的屬性或方法參數(shù)。
必須指定正則表達(dá)式，例如@Pattern(regexp=“^[a-zA-Z0-9]+$”)。

@Email：

用于標(biāo)記字符串類(lèi)型的屬性或方法參數(shù)必須符合電子郵件地址的格式。
適用于String類(lèi)型的屬性或方法參數(shù)。
驗(yàn)證字符串是否符合電子郵件地址的格式。

其他注解

@Past：用于驗(yàn)證日期或時(shí)間類(lèi)型的屬性或方法參數(shù)必須在當(dāng)前時(shí)間之前。
@Future：用于驗(yàn)證日期或時(shí)間類(lèi)型的屬性或方法參數(shù)必須在當(dāng)前時(shí)間之后。
@URL：用于驗(yàn)證字符串類(lèi)型的屬性或方法參數(shù)必須符合URL的格式。
@IP：用于驗(yàn)證字符串類(lèi)型的屬性或方法參數(shù)必須符合IP地址的格式。

這些注解僅提供了基本的驗(yàn)證規(guī)則，可以根據(jù)實(shí)際需求進(jìn)行組合和自定義注解以滿(mǎn)足特定的驗(yàn)證需求。此外，還可以使用繼承和組合注解來(lái)擴(kuò)展驗(yàn)證規(guī)則

javax.validation.constraints中@NotBlank和@NotEmpty的區(qū)別

在Java的javax.validation.constraints包中，@NotBlank和@NotEmpty是用于驗(yàn)證屬性值非空的注解，它們之間有一些區(qū)別。

@NotBlank

@NotBlank 用于驗(yàn)證一個(gè)字符串是否為非空，它會(huì)去除字符串兩端的空格后再判斷是否為空。

@NotBlank 可以用在 String 類(lèi)型的字段上。

例如，@NotBlank 用在一個(gè) String 類(lèi)型的字段上，如果該字段為 null、空字符串或只包含空格，都會(huì)觸發(fā)驗(yàn)證失敗。

示例：

public class User { @NotBlank private String username; }

@NotEmpty

@NotEmpty 用于驗(yàn)證一個(gè)集合（Collection）、Map、數(shù)組或字符串是否非空，它不會(huì)去除字符串兩端的空格，而是直接判斷是否為空。

@NotEmpty 可以用在 Collection、Map、數(shù)組和 String 類(lèi)型的字段上。

例如，@NotEmpty 用在一個(gè)集合類(lèi)型的字段上，如list 或 JSONArray，如果該集合為空，會(huì)觸發(fā)驗(yàn)證失敗。

示例：

public class User { @NotEmpty private List<String> phoneNumbers; }

    @ApiModelProperty("結(jié)束日期（包含）")
    @NotNull
    private Date endDate;
 
    @ApiModelProperty("任務(wù)生成周天（1,2,3,4,5,6,7）")
    @NotNull
    private String weekDay;
 
    @ApiModelProperty("巡檢當(dāng)天時(shí)間班次")
    @NotEmpty
    private JSONArray period;