欧美bbbwbbbw肥妇,免费乱码人妻系列日韩,一级黄片

關(guān)于javax.validation.constraints的超詳細(xì)說明

 更新時間：2025年07月09日 09:21:46   作者：悟能不能悟  
這篇文章主要給大家介紹了關(guān)于javax.validation.constraints的超詳細(xì)說明,文中通過代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考借鑒價值,需要的朋友可以參考下

前言

以下是關(guān)于 javax.validation.constraints（現(xiàn)為 ?Jakarta Bean Validation）的詳細(xì)說明，涵蓋核心注解、使用場景、代碼示例及最佳實踐：

一、javax.validation.constraints 是什么？

  • ?作用?：提供一組標(biāo)準(zhǔn)注解，用于對 Java Bean 的字段或方法參數(shù)進(jìn)行數(shù)據(jù)校驗（如非空、長度、范圍等）。
  • ?規(guī)范演進(jìn)?：
    • Java EE 時期：包名為 javax.validation.constraints。
    • Jakarta EE 9+：包名遷移為 jakarta.validation.constraints（需注意依賴兼容性）。

二、核心注解列表及用法

1. 常用注解

?注解??校驗規(guī)則??支持類型?
@NotNull值不能為 null任意類型
@NotBlank字符串不能為空或純空格String
@NotEmpty集合/數(shù)組/字符串不能為空（長度 > 0）Collection, String 等
@Size(min, max)元素數(shù)量或字符串長度在指定范圍內(nèi)集合、數(shù)組、字符串
@Min(value)數(shù)值必須 ≥ 指定最小值數(shù)值類型（int, long 等）
@Max(value)數(shù)值必須 ≤ 指定最大值同上
@DecimalMin(value)數(shù)值必須 ≥ 指定最小值（字符串形式，支持精度）BigDecimal, String 等
@DecimalMax(value)數(shù)值必須 ≤ 指定最大值（字符串形式，支持精度）同上
@Digits(integer, fraction)數(shù)值整數(shù)部分最多 integer 位，小數(shù)部分最多 fraction 位數(shù)值類型
@Pattern(regexp)字符串必須匹配正則表達(dá)式String
@Email字符串必須是合法郵箱格式String
@Positive / @PositiveOrZero數(shù)值必須為正數(shù)或零數(shù)值類型
@Negative / @NegativeOrZero數(shù)值必須為負(fù)數(shù)或零數(shù)值類型
@Future / @FutureOrPresent日期必須在未來（或包含當(dāng)前）Date, LocalDate 等
@Past / @PastOrPresent日期必須在過去（或包含當(dāng)前）同上

2. 注解示例代碼

public class User {
    @NotBlank(message = "用戶名不能為空")
    private String username;

    @Email(message = "郵箱格式無效")
    private String email;

    @Size(min = 6, max = 20, message = "密碼長度需在6-20位之間")
    private String password;

    @Min(value = 18, message = "年齡必須≥18歲")
    @Max(value = 100, message = "年齡必須≤100歲")
    private Integer age;

    @Pattern(regexp = "^1[3-9]\\d{9}$", message = "手機(jī)號格式無效")
    private String phone;
}

三、集成到 Spring Boot 中的步驟

1. 添加依賴

<!-- Spring Boot 2.x 使用 javax.validation -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

<!-- Jakarta EE 9+ 使用 jakarta.validation -->
<dependency>
    <groupId>jakarta.validation</groupId>
    <artifactId>jakarta.validation-api</artifactId>
    <version>3.0.2</version>
</dependency>

2. 在 Controller 中觸發(fā)校驗

使用 @Valid 或 @Validated 注解觸發(fā)校驗：

@PostMapping("/users")
public ResponseEntity<?> createUser(@RequestBody @Valid User user) {
    // 校驗通過后執(zhí)行業(yè)務(wù)邏輯
    return ResponseEntity.ok("用戶創(chuàng)建成功");
}

3. 處理校驗異常

通過 @ExceptionHandler 捕獲 MethodArgumentNotValidException：

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<Map<String, String>> handleValidationException(MethodArgumentNotValidException ex) {
        Map<String, String> errors = new HashMap<>();
        ex.getBindingResult().getAllErrors().forEach(error -> {
            String fieldName = ((FieldError) error).getField();
            String errorMessage = error.getDefaultMessage();
            errors.put(fieldName, errorMessage);
        });
        return ResponseEntity.badRequest().body(errors);
    }
}

四、高級用法

1. 分組校驗

通過分組接口實現(xiàn)不同場景下的差異化校驗：

// 定義分組接口
public interface CreateGroup {}
public interface UpdateGroup {}

public class User {
    @NotNull(groups = UpdateGroup.class)
    private Long id;

    @NotBlank(groups = {CreateGroup.class, UpdateGroup.class})
    private String name;
}

// 在 Controller 中指定分組
@PostMapping("/users")
public ResponseEntity<?> createUser(@RequestBody @Validated(CreateGroup.class) User user) { ... }

2. 自定義校驗注解

實現(xiàn)自定義校驗邏輯（如密碼強(qiáng)度校驗）：

@Target({FIELD})
@Retention(RUNTIME)
@Constraint(validatedBy = PasswordValidator.class)
public @interface StrongPassword {
    String message() default "密碼必須包含大小寫字母和數(shù)字";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

public class PasswordValidator implements ConstraintValidator<StrongPassword, String> {
    @Override
    public boolean isValid(String password, ConstraintValidatorContext context) {
        return password.matches("^(?=.*[a-z])(?=.*[A-Z])(?=.*\\d).+$");
    }
}

3. 級聯(lián)校驗

校驗對象內(nèi)的嵌套對象：

public class Order {
    @Valid
    private List<@Valid Product> products; // 校驗每個 Product 的字段
}

五、校驗失敗的錯誤消息定制

1. 默認(rèn)消息模板

每個注解的 message 屬性支持占位符：

@Size(min = 6, max = 20, message = "密碼長度需在{min}-{max}位之間")
private String password;

2. 國際化消息

在 messages.properties 或 ValidationMessages.properties 中定義：

user.email.invalid=郵箱格式無效

注解中使用：

@Email(message = "{user.email.invalid}")
private String email;

六、常見問題與解決方案

?問題??解決方案?
校驗未生效檢查是否添加了 @Valid 或 @Validated 注解；確認(rèn)依賴已正確引入
嵌套對象校驗失敗在嵌套對象字段上添加 @Valid 注解
分組校驗不生效在 @Validated 注解中明確指定分組接口
自定義校驗器未觸發(fā)確認(rèn) @Constraint(validatedBy = MyValidator.class) 并實現(xiàn) ConstraintValidator

七、總結(jié)

  • ?核心價值?：通過聲明式注解簡化數(shù)據(jù)校驗邏輯，減少樣板代碼。
  • ?最佳實踐?：
    • 優(yōu)先使用標(biāo)準(zhǔn)注解，避免重復(fù)造輪子。
    • 結(jié)合分組校驗實現(xiàn)多場景復(fù)用。
    • 統(tǒng)一處理校驗異常，返回清晰的錯誤信息。
  • ?擴(kuò)展性?：通過自定義注解和校驗器滿足復(fù)雜業(yè)務(wù)需求。

到此這篇關(guān)于關(guān)于javax.validation.constraints超詳細(xì)說明的文章就介紹到這了,更多相關(guān)javax.validation.constraints說明內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

相關(guān)文章

  • Kotlin與Java的主客觀對比分析

    Kotlin與Java的主客觀對比分析

    這篇文章主要介紹了Kotlin與Java的主客觀對比分析，具有一定借鑒價值，需要的朋友可以參考下。
    2017-12-12
  • 深入理解Java設(shè)計模式之狀態(tài)模式

    深入理解Java設(shè)計模式之狀態(tài)模式

    這篇文章主要介紹了JAVA設(shè)計模式之職責(zé)鏈模式的的相關(guān)資料，文中示例代碼非常詳細(xì)，供大家參考和學(xué)習(xí)，感興趣的朋友可以了解
    2021-11-11
  • Java線程的基本概念

    Java線程的基本概念

    本文主要介紹了Java線程的基本概念。具有很好的參考價值，下面跟著小編一起來看下吧
    2017-02-02
  • Kotlin Coroutines執(zhí)行異步加載示例詳解

    Kotlin Coroutines執(zhí)行異步加載示例詳解

    這篇文章主要給大家介紹了關(guān)于Kotlin Coroutines執(zhí)行異步加載的相關(guān)資料，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧。
    2018-01-01
  • 解決SpringBoot運行報錯：找不到或無法加載主類的問題

    解決SpringBoot運行報錯：找不到或無法加載主類的問題

    這篇文章主要介紹了解決SpringBoot運行報錯：找不到或無法加載主類的問題,具有很好的參考價值,對大家的學(xué)習(xí)或工作有一定的參考價值,需要的朋友可以參考下
    2023-09-09
  • Java-文件File簡單實用方法(分享)

    Java-文件File簡單實用方法(分享)

    下面小編就為大家?guī)硪黄狫ava-文件File簡單實用方法(分享)。小編覺得挺不錯的，現(xiàn)在就分享給大家，也給大家做個參考。一起跟隨小編過來看看吧
    2017-08-08
  • Java中的IO讀寫原理詳解

    Java中的IO讀寫原理詳解

    這篇文章主要介紹了Java中的IO讀寫原理,IO是指輸入和輸出操作的技術(shù),它提供了一組用于讀取和寫入數(shù)據(jù)的類,以及用于處理字符和字節(jié)數(shù)據(jù)的接口,這些類和接口可以用于讀取和寫入文件、網(wǎng)絡(luò)流、內(nèi)存緩沖區(qū)等各種數(shù)據(jù)源和目標(biāo),需要的朋友可以參考下
    2023-08-08
  • Java實現(xiàn)雙端鏈表LinkedList

    Java實現(xiàn)雙端鏈表LinkedList

    本文主要介紹了Java實現(xiàn)雙端鏈表LinkedList，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧
    2022-07-07
  • Java數(shù)據(jù)結(jié)構(gòu)之散列表(動力節(jié)點Java學(xué)院整理)

    Java數(shù)據(jù)結(jié)構(gòu)之散列表(動力節(jié)點Java學(xué)院整理)

    散列表(Hash table，也叫哈希表)，是根據(jù)關(guān)鍵字(key value)而直接進(jìn)行訪問的數(shù)據(jù)結(jié)構(gòu)。這篇文章給大家介紹了java數(shù)據(jù)結(jié)構(gòu)之散列表，包括基本概念和散列函數(shù)相關(guān)知識，需要的的朋友參考下吧
    2017-04-04
  • SpringBoot整合支付寶APP支付

    SpringBoot整合支付寶APP支付

    這篇文章主要為大家詳細(xì)介紹了SpringBoot整合支付寶APP支付，具有一定的參考價值，感興趣的小伙伴們可以參考一下
    2019-08-08

最新評論