// UserDTO實(shí)體類
class UserDto {
    private String name;
    private Integer age;
    private String email;
    
    // getter和setter省略
}

@RestController
@RequestMapping("/user")
public class UserController {
    
    @PostMapping("/add")
    public String addUser(UserDto user) {
        // 手動校驗(yàn)參數(shù)
        if (user.getName() == null || user.getName().trim().isEmpty()) {
            return "用戶名不能為空";
        }
        if (user.getName().length() < 5 || user.getName().length() > 10) {
            return "用戶名長度必須在5-10之間";
        }
        if (user.getAge() == null) {
            return "年齡不能為空";
        }
        if (user.getAge() < 18 || user.getAge() > 60) {
            return "年齡必須在18-60之間";
        }
        if (user.getEmail() == null || user.getEmail().trim().isEmpty()) {
            return "郵箱不能為空";
        }
        if (!user.getEmail().matches("^[A-Za-z0-9+_.-]+@[A-Za-z0-9.-]+$")) {
            return "郵箱格式不正確";
        }
        
        // 業(yè)務(wù)邏輯處理
        return "用戶添加成功";
    }
}

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

import javax.validation.constraints.*;

public class UserDto {

    @NotBlank(message = "用戶名不能為空")
    @Size(min = 2, max = 10, message = "用戶名長度必須在{min}-{max}之間")
    private String username;

    @NotBlank(message = "郵箱不能為空")
    @Email(message = "郵箱格式不正確") // 自帶郵箱格式校驗(yàn)，無需自己寫正則！
    private String email;

    @NotNull(message = "年齡不能為空")
    @Min(value = 0, message = "年齡最小為{value}")
    @Max(value = 150, message = "年齡最大為{value}")
    private Integer age;

    // 省略 Getter 和 Setter...
}

import javax.validation.Valid;

@RestController
@RequestMapping("/user")
public class UserController {

    @PostMapping("/add")
    // 關(guān)鍵一步：在 @RequestBody 前加上 @Valid 注解
    public String addUser(@Valid @RequestBody UserDto user) {
        // 只需關(guān)注核心業(yè)務(wù)
        System.out.println("用戶創(chuàng)建成功: " + user);
        return "success";
    }
}

import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import java.util.HashMap;
import java.util.Map;
import java.util.Objects;

@RestControllerAdvice
public class GlobalExceptionHandler {

    /**
     * 處理實(shí)體校驗(yàn)異常
     */
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public Map<String, Object> handleValidException(MethodArgumentNotValidException e) {
        Map<String, Object> errorResult = new HashMap<>();
        errorResult.put("code", 400);
        errorResult.put("message", "參數(shù)校驗(yàn)失敗");
        // 從異常對象中拿到具體的錯誤信息
        // 這里只取第一個錯誤信息，也可以全部返回
        String defaultMessage = Objects.requireNonNull(e.getBindingResult().getFieldError()).getDefaultMessage();
        errorResult.put("data", defaultMessage);
        return errorResult;
    }
}

public interface CreateGroup {} // 創(chuàng)建分組
public interface UpdateGroup {} // 更新分組

public class UserDto {
    @Null(groups = CreateGroup.class, message = "創(chuàng)建時(shí)ID必須為空")
    @NotNull(groups = UpdateGroup.class, message = "更新時(shí)ID不能為空")
    private Long id;

    @NotBlank(message = "用戶名不能為空", groups = {CreateGroup.class, UpdateGroup.class})
    private String username;
    // ... 其他字段
}

@PostMapping("/create")
public String create(@Validated(CreateGroup.class) @RequestBody UserDto user) {
    // ... 創(chuàng)建邏輯
}

@PostMapping("/update")
public String update(@Validated(UpdateGroup.class) @RequestBody UserDto user) {
    // ... 更新邏輯
}