import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.*;
@Target({ElementType.FIELD, ElementType.PARAMETER}) // 作用于字段和方法參數(shù)
@Retention(RetentionPolicy.RUNTIME) // 運(yùn)行時生效
@Constraint(validatedBy = PhoneValidator.class) // 關(guān)聯(lián)校驗器
public @interface Phone {
    String message() default "手機(jī)號格式錯誤"; // 錯誤提示
    Class<?>[] groups() default {}; // 分組校驗（如新增、更新）
    Class<? extends Payload>[] payload() default {}; // 負(fù)載信息（可選）
    String region() default "CN"; // 自定義屬性：地區(qū)（默認(rèn)中國）
}

import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;
public class PhoneValidator implements ConstraintValidator<Phone, String> {
    private String region; // 存儲注解的region屬性
    @Override
    public void initialize(Phone constraintAnnotation) {
        this.region = constraintAnnotation.region(); // 初始化，獲取地區(qū)配置
    }
    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        if (value == null) return true; // 允許為空（若必填需額外處理，如@NotBlank配合使用）
        // 根據(jù)地區(qū)校驗格式
        switch (region) {
            case "CN": // 中國手機(jī)號：11位，以1開頭，第二位3-9
                return value.matches("^1[3-9]\\d{9}$");
            case "US": // 美國手機(jī)號：+1開頭，后跟10位數(shù)字
                return value.matches("^\\+1\\d{10}$");
            default:
                return false; // 未知地區(qū)，校驗失敗
        }
    }
}

public class UserDTO {
    @NotBlank
    private String username;
    @Phone(region = "CN") // 校驗中國手機(jī)號
    private String phone;
    // 若需校驗美國手機(jī)號，可設(shè)置region="US"
    // @Phone(region = "US")
    // private String usPhone;
    // getters/setters
}

import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;
@RestController
public class UserController {
    @PostMapping("/register")
    public String register(@Validated @RequestBody UserDTO dto) {
        // 校驗通過，執(zhí)行注冊邏輯
        return "注冊成功";
    }
}

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.BindingResult;
import org.springframework.validation.FieldError;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
@ControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<ErrorResponse> handleValidationError(MethodArgumentNotValidException ex) {
        BindingResult result = ex.getBindingResult();
        StringBuilder errorMsg = new StringBuilder();
        for (FieldError error : result.getFieldErrors()) {
            errorMsg.append(error.getField()).append(": ").append(error.getDefaultMessage()).append("; ");
        }
        return ResponseEntity
                .status(HttpStatus.BAD_REQUEST)
                .body(new ErrorResponse(HttpStatus.BAD_REQUEST.value(), errorMsg.toString()));
    }
    static class ErrorResponse {
        private int code;
        private String message;
        public ErrorResponse(int code, String message) {
            this.code = code;
            this.message = message;
        }
        // getters
    }
}

// 定義分組接口
public interface CreateGroup {}
public interface UpdateGroup {}
// 在DTO中指定分組
@Phone(region = "CN", groups = CreateGroup.class) // 新增時校驗手機(jī)號
private String phone;
// Controller中使用分組
@PostMapping("/create")
public String create(@Validated(CreateGroup.class) @RequestBody UserDTO dto) { ... }
@PutMapping("/update")
public String update(@Validated(UpdateGroup.class) @RequestBody UserDTO dto) { ... }

Phone.message=手機(jī)號格式錯誤（中文）
Phone.message_en=Invalid phone number format（英文）

// 校驗器中注入Service（需將校驗器標(biāo)記為@Component，由Spring管理）
@Component
public class PhoneValidator implements ConstraintValidator<Phone, String> {
    @Autowired
    private UserService userService; // 假設(shè)UserService提供手機(jī)號唯一性查詢
    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        // 先校驗格式，再校驗唯一性
        if (!isFormatValid(value)) return false;
        return !userService.existsByPhone(value); // 假設(shè)existsByPhone查詢數(shù)據(jù)庫
    }
    private boolean isFormatValid(String value) {
        // 復(fù)用之前的格式校驗邏輯
        return value.matches("^1[3-9]\\d{9}$");
    }
}