javax.validation.constraints注解

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

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

開發(fā)者可以通過在對象的屬性上添加這些注解，來定義相應的驗證規(guī)則。

常用的注解

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

• 適用于任何類型的屬性或方法參數(shù)。
• 不能用于基本數(shù)據(jù)類型，因為它們不接受null值。

@NotEmpty：

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

@NotBlank：

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

@Min：

• 用于標記數(shù)值類型的屬性或方法參數(shù)的最小值。
• 適用于byte、short、int、long和對應的包裝類類型的屬性或方法參數(shù)。

@Max：

• 用于標記數(shù)值類型的屬性或方法參數(shù)的最大值。
• 適用于byte、short、int、long和對應的包裝類類型的屬性或方法參數(shù)。

@Size：

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

@Pattern：

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

@Email：

• 用于標記字符串類型的屬性或方法參數(shù)必須符合電子郵件地址的格式。
• 適用于String類型的屬性或方法參數(shù)。
• 驗證字符串是否符合電子郵件地址的格式。

其他注解

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

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

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

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

@NotBlank

@NotBlank 用于驗證一個字符串是否為非空，它會去除字符串兩端的空格后再判斷是否為空。

@NotBlank 可以用在 String 類型的字段上。

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

示例：

public class User { @NotBlank private String username; }

@NotEmpty

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

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

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

示例：

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

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

心得

• @NotBlank 主要用于驗證字符串類型的字段是否非空，會去除兩端空格后再進行判斷。
• @NotEmpty 用于驗證集合、Map、數(shù)組或字符串類型的字段是否非空，不會去除空格，直接判斷是否為空。

根據(jù)具體的需求，你可以選擇使用 @NotBlank 或 @NotEmpty 進行屬性非空的驗證。

總結(jié)

以上為個人經(jīng)驗，希望能給大家一個參考，也希望大家多多支持腳本之家。

最新評論