@PostMapping("/parameterCheck")
    @Operation(summary = "參數(shù)校驗(yàn)", description = "嵌套參數(shù)校驗(yàn)-測(cè)試")
    public CommonResult<TestDto> parameterCheck(@RequestBody TestDto dto) {
        if (dto == null){
            throw new RuntimeException("參數(shù)不能為空");
        }
        return CommonResult.SUCCESS(dto);
    }

    @PostMapping("/parameterCheck")
    @Operation(summary = "參數(shù)校驗(yàn)", description = "嵌套參數(shù)校驗(yàn)-測(cè)試")
    public CommonResult<TestDto> parameterCheck(@RequestBody TestDto dto) {
        Assert.isNull(dto.getName(), "姓名不能為空");
        Assert.isNull(dto.getSex(), "性別不能為空");
        return CommonResult.SUCCESS(dto);
    }

        <!-- 如果spring-boot版本小于2.3.x，spring-boot-starter-web會(huì)自動(dòng)傳入hibernate-validator依賴(lài)。如果spring-boot版本大于2.3.x，則需要手動(dòng)引入依賴(lài) -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-validation</artifactId>
        </dependency>

import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.Valid;
import jakarta.validation.constraints.*;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@AllArgsConstructor
@NoArgsConstructor
public class TestDto {

    @NotBlank(message = "姓名不能為空")
    @Schema(description = "姓名")
    private String name;

    @NotNull(message = "年齡不能為空")
    @Schema(description = "年齡")
    @Min(value = 0, message = "年齡不能小于0")
    @Max(value = 200, message = "年齡不能大于200")
    private Integer age;

    //性別只允許為男或女
    @NotBlank(message = "性別不能為空")
    @Pattern(regexp = "^(男|女)$", message = "性別必須為'男'或'女'")
    @Schema(description = "性別")
    private String sex;

    @Valid
    @Schema(description = "嵌套對(duì)象")
    private TestDtoObj testDtoObj;
}

import com.example.demo.annotation.PhoneNumber;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.*;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.hibernate.validator.constraints.URL;
import java.time.LocalDate;
import java.time.LocalDateTime;

@Data
@AllArgsConstructor
@NoArgsConstructor
public class TestDtoObj {

    @PhoneNumber
    @NotBlank(message = "手機(jī)號(hào)1不能為空")
    @Schema(description = "手機(jī)號(hào)1")
    private String phone1;

    @Pattern(regexp = "^1[3-9]\\d{9}$", message = "無(wú)效的手機(jī)號(hào)碼格式")
    @NotBlank(message = "手機(jī)號(hào)不能為空")
    @Schema(description = "手機(jī)號(hào)2")
    private String phone2;

    @NotBlank(message = "密碼不能為空")
    @Size(min = 6, max = 16, message = "密碼長(zhǎng)度必須在6到16個(gè)字符之間")
    @Schema(description = "密碼")
    private String password;

    @NotBlank(message = "郵箱不能為空")
    @Pattern(regexp = "^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$", message = "郵箱格式不正確")
    @Schema(description = "郵箱")
    private String email;

    @Digits(integer = 4, fraction = 2, message = "整數(shù)位數(shù)必須在4位以?xún)?nèi)小數(shù)位數(shù)必須在2位以?xún)?nèi)")
    @Schema(description = "小數(shù)")
    private Double num;

    @URL(message = "url格式錯(cuò)誤")
    @Schema(description = "地址")
    private String url;

    @Past(message = "日期必須為過(guò)去日期")
    @Schema(description = "過(guò)去日期")
    private LocalDate pastDate;

    @Future(message = "日期必須為將來(lái)日期")
    @Schema(description = "將來(lái)日期")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss",timezone = "GMT+8")
    private LocalDateTime futureDate;

}

/**
 * 全局異常攔截
 * 
 * @author zyw
 */
@Slf4j
@RestControllerAdvice
public class BaseExceptionHandler {

    /**
     * 攔截參數(shù)校驗(yàn)異常
     * @param e
     * @param request
     * @return
     */
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public CommonResult<?> handleGlobalException(MethodArgumentNotValidException e, HttpServletRequest request) {
        log.error("請(qǐng)求地址'{}',發(fā)生系統(tǒng)異常'{}'", request.getRequestURI(), e.getBindingResult().getFieldError().getDefaultMessage());
        return CommonResult.ECEPTION(ResultCode.PARAMETER_EXCEPTION, e.getBindingResult().getFieldError().getDefaultMessage());
    }

}

import com.example.demo.config.CommonResult;
import com.example.demo.model.dto.TestDto;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.enums.ParameterIn;
import io.swagger.v3.oas.annotations.tags.Tag;
import lombok.extern.slf4j.Slf4j;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;

@RestController
@Slf4j
@RequestMapping("knife4j")
@Tag(name = "knife4j測(cè)試控制器")
public class Knife4jController {
    @PostMapping("/parameterCheck")
    @Operation(summary = "參數(shù)校驗(yàn)", description = "嵌套參數(shù)校驗(yàn)-測(cè)試")
    public CommonResult<TestDto> parameterCheck(@Validated @RequestBody TestDto dto) {
        return CommonResult.SUCCESS(dto);
    }
}

import com.example.demo.uitls.validator.PhoneNumberValidator;
import jakarta.validation.Constraint;
import jakarta.validation.Payload;
import java.lang.annotation.*;

/**
 * PhoneNumber : 手機(jī)號(hào)格式驗(yàn)證注解
 * 用于驗(yàn)證電話(huà)號(hào)碼格式的注解。
 * 該注解可以應(yīng)用于字段或參數(shù)上，以驗(yàn)證其是否為有效的電話(huà)號(hào)碼格式。
 * 默認(rèn)的錯(cuò)誤消息是“無(wú)效的手機(jī)號(hào)碼格式”，但可以通過(guò)message屬性自定義。
 * 可以通過(guò)groups和payload屬性來(lái)支持分組驗(yàn)證和負(fù)載信息。
 *
 * @Documented 標(biāo)記此注解將被包含在文檔中。
 * @Constraint 標(biāo)記此注解為約束注解，并指定PhoneNumberValidator類(lèi)作為驗(yàn)證器。
 * @Target 指定此注解可以應(yīng)用于字段和參數(shù)上。
 * @Retention 指定此注解在運(yùn)行時(shí)保留。
 * @author zyw
 * @create 2024-05-31  15:38
 */

@Documented
@Constraint(validatedBy = PhoneNumberValidator.class)
@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
public @interface PhoneNumber {
    /**
     * 驗(yàn)證失敗時(shí)的錯(cuò)誤消息，默認(rèn)為“無(wú)效的手機(jī)號(hào)碼格式”。
     * 可以通過(guò)將此屬性設(shè)置為自定義錯(cuò)誤消息來(lái)更改默認(rèn)消息。
     *
     * @return 驗(yàn)證失敗時(shí)的錯(cuò)誤消息。
     */
    String message() default "無(wú)效的手機(jī)號(hào)碼格式";
    /**
     * 定義驗(yàn)證的分組，默認(rèn)為空組。
     * 可以通過(guò)將此屬性設(shè)置為一個(gè)或多個(gè)分組類(lèi)來(lái)指定字段應(yīng)在哪些分組中進(jìn)行驗(yàn)證。
     *
     * @return 驗(yàn)證的分組類(lèi)數(shù)組。
     */
    Class<?>[] groups() default {};
    /**
     * 定義驗(yàn)證的負(fù)載信息，默認(rèn)為空負(fù)載。
     * 可以通過(guò)將此屬性設(shè)置為一個(gè)或多個(gè)負(fù)載類(lèi)來(lái)攜帶額外的驗(yàn)證信息。
     *
     * @return 驗(yàn)證的負(fù)載信息類(lèi)數(shù)組。
     */
    Class<? extends Payload>[] payload() default {};
}

import com.example.demo.annotation.PhoneNumber;
import jakarta.validation.ConstraintValidator;
import jakarta.validation.ConstraintValidatorContext;

/**
 * PhoneNumberValidator : 手機(jī)號(hào)驗(yàn)證器類(lèi)
 *
 * @author zyw
 * @create 2024-05-31  15:39
 */

public class PhoneNumberValidator implements ConstraintValidator<PhoneNumber, String> {
    private static final String PHONE_PATTERN = "^1[3-9]\\d{9}$"; // 中國(guó)手機(jī)號(hào)碼的簡(jiǎn)單正則表達(dá)式

    @Override
    public boolean isValid(String phoneNumber, ConstraintValidatorContext context) {
        return phoneNumber != null && phoneNumber.matches(PHONE_PATTERN);
    }
}

import com.example.demo.annotation.PhoneNumber;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.*;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.hibernate.validator.constraints.URL;
import java.time.LocalDate;
import java.time.LocalDateTime;

/**
 * TestDtoObj :
 *
 * @author zyw
 * @create 2024-05-31  15:47
 */

@Data
@AllArgsConstructor
@NoArgsConstructor
public class TestDtoObj {

    @PhoneNumber
    @PhoneNumber(message = "手機(jī)號(hào)格式錯(cuò)誤")
    @Schema(description = "手機(jī)號(hào)1")
    private String phone1;

    @Pattern(regexp = "^1[3-9]\\d{9}$", message = "無(wú)效的手機(jī)號(hào)碼格式")
    @NotBlank(message = "手機(jī)號(hào)不能為空")
    @Schema(description = "手機(jī)號(hào)2")
    private String phone2;

}

@PhoneNumber
@PhoneNumber(message = "手機(jī)號(hào)格式錯(cuò)誤")
@Schema(description = "手機(jī)號(hào)1")
private String phone1;

@Pattern(regexp = "^1[3-9]\\d{9}$", message = "無(wú)效的手機(jī)號(hào)碼格式")
@NotBlank(message = "手機(jī)號(hào)不能為空")
@Schema(description = "手機(jī)號(hào)2")
private String phone2;