<dependencies>
    <!-- Spring Boot Web 核心 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- Lombok 簡化實體類代碼 -->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <optional>true</optional>
    </dependency>
    <!-- 參數(shù)校驗（用于后續(xù)異常場景） -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-validation</artifactId>
    </dependency>
</dependencies>

import jakarta.validation.constraints.Min;
import jakarta.validation.constraints.NotBlank;
import lombok.Data;
@Data // 自動生成getter、setter、toString等方法
public class Pet {
    private Long id;         // 寵物ID（唯一標識）
    @NotBlank(message = "寵物名稱不能為空")
    private String name;     // 寵物名稱
    @NotBlank(message = "寵物品種不能為空")
    private String breed;    // 寵物品種（如"金毛"、"布偶貓"）
    @Min(value = 0, message = "寵物年齡不能為負數(shù)")
    private Integer age;     // 寵物年齡（單位：歲）
}

import org.springframework.stereotype.Service;
import java.util.HashMap;
import java.util.Map;
@Service
public class PetService {
    // 模擬數(shù)據(jù)庫存儲寵物數(shù)據(jù)
    private static final Map<Long, Pet> PET_MAP = new HashMap<>();
    // 初始化測試數(shù)據(jù)
    static {
        PET_MAP.put(1L, new Pet(1L, "旺財", "金毛", 3));
        PET_MAP.put(2L, new Pet(2L, "咪寶", "布偶貓", 2));
    }
    // 根據(jù)ID查詢寵物
    public Pet getPetById(Long id) {
        return PET_MAP.get(id);
    }
    // 新增寵物
    public Pet addPet(Pet pet) {
        long newId = PET_MAP.size() + 1;
        pet.setId(newId);
        PET_MAP.put(newId, pet);
        return pet;
    }
    // 刪除寵物
    public boolean deletePet(Long id) {
        return PET_MAP.remove(id) != null;
    }
}

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping("/pets")
public class PetController {
    @Autowired
    private PetService petService;
    // 場景1：查詢單個寵物（成功返回200）
    @GetMapping("/{id}")
    public ResponseEntity<Pet> getPet(@PathVariable Long id) {
        Pet pet = petService.getPetById(id);
        // ResponseEntity.ok() 等價于 ResponseEntity.status(200).body(pet)
        return ResponseEntity.ok(pet);
    }
}

{
    "id": 1,
    "name": "旺財",
    "breed": "金毛",
    "age": 3
}

// 場景2：新增寵物（返回201 + 自定義響應(yīng)頭）
@PostMapping
public ResponseEntity<Pet> addPet(@Valid @RequestBody Pet pet) {
    Pet newPet = petService.addPet(pet);
    // 構(gòu)建響應(yīng)：狀態(tài)碼201 + Location響應(yīng)頭 + 新增寵物數(shù)據(jù)
    return ResponseEntity
            .status(201) // 等價于 ResponseEntity.created(URI.create("/pets/" + newPet.getId()))
            .header("Location", "/pets/" + newPet.getId())
            .body(newPet);
}

{
    "name": "小白",
    "breed": "薩摩耶",
    "age": 1
}

{
    "id": 3,
    "name": "小白",
    "breed": "薩摩耶",
    "age": 1
}

// 場景3：刪除寵物（成功204，失敗404）
@DeleteMapping("/{id}")
public ResponseEntity<Void> deletePet(@PathVariable Long id) {
    boolean isDeleted = petService.deletePet(id);
    if (isDeleted) {
        // 204 無響應(yīng)體，使用 ResponseEntity.noContent().build()
        return ResponseEntity.noContent().build();
    } else {
        // 404 未找到
        return ResponseEntity.notFound().build();
    }
}

// 場景4：改造查詢接口，不存在則返回404 + 錯誤信息
@GetMapping("/{id}")
public ResponseEntity<Object> getPet(@PathVariable Long id) {
    Pet pet = petService.getPetById(id);
    if (pet != null) {
        return ResponseEntity.ok(pet);
    } else {
        // 構(gòu)建自定義錯誤響應(yīng)體，狀態(tài)碼404
        Map<String, String> error = new HashMap<>();
        error.put("code", "PET_NOT_FOUND");
        error.put("message", "寵物ID：" + id + " 不存在");
        return ResponseEntity.status(404).body(error);
    }
}

{
    "code": "PET_NOT_FOUND",
    "message": "寵物ID：99 不存在"
}

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.FieldError;
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;
@RestControllerAdvice // 全局異常處理
public class GlobalExceptionHandler {
    // 處理參數(shù)校驗異常
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<Map<String, String>> handleValidationExceptions(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);
        });
        // 返回400 + 錯誤信息
        return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(errors);
    }
}

{
    "name": "",
    "breed": "哈士奇",
    "age": -1
}

{
    "name": "寵物名稱不能為空",
    "age": "寵物年齡不能為負數(shù)"
}

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>Axios 處理 ResponseEntity 示例</title>
    <!-- 引入 Axios -->
    <script src="https://cdn.jsdelivr.net/npm/axios/dist/axios.min.js"></script>
</head>
<body>
    <button onclick="sendPetRequest()">發(fā)送新增寵物請求</button>
    <script>
        // 核心：發(fā)送POST請求并處理ResponseEntity返回內(nèi)容
        async function sendPetRequest() {
            try {
                // 1. 構(gòu)造請求參數(shù)（與后端Pet實體匹配）
                const petData = {
                    name: "小白",
                    breed: "薩摩耶",
                    age: 1
                };
                // 2. 發(fā)送POST請求，調(diào)用后端返回ResponseEntity的接口
                const response = await axios.post(
                    'http://localhost:8080/pets', // 后端接口地址
                    petData // 請求體
                );
                // 3. 控制臺打印ResponseEntity的核心返回內(nèi)容（重點?。?
                console.log("===== ResponseEntity 返回內(nèi)容解析 =====");
                console.log("1. HTTP狀態(tài)碼（ResponseEntity.status）：", response.status); // 201
                console.log("2. 響應(yīng)頭（ResponseEntity.header設(shè)置的內(nèi)容）：", response.headers); // 含Location等
                console.log("3. Location響應(yīng)頭具體值：", response.headers.location); // /pets/3
                console.log("4. 響應(yīng)體（ResponseEntity.body）：", response.data); // 新增的Pet對象
                console.log("========================================");
            } catch (error) {
                // 4. 異常場景：解析錯誤的ResponseEntity內(nèi)容
                console.log("===== 錯誤的ResponseEntity返回內(nèi)容 =====");
                if (error.response) {
                    // 后端返回了錯誤的ResponseEntity（如400/404）
                    console.log("錯誤狀態(tài)碼：", error.response.status); // 400/404等
                    console.log("錯誤響應(yīng)體：", error.response.data); // 后端返回的錯誤信息
                } else {
                    console.log("請求異常：", error.message); // 網(wǎng)絡(luò)/配置錯誤
                }
            }
        }
    </script>
</body>
</html>