ResponseEntity 类详解

        `ResponseEntity` 是 Spring Framework 中一个非常重要的类，它用于构建 HTTP 响应。它提供了灵活的方式来创建完整的 HTTP 响应，包括状态码、响应头和响应体。这个类在处理 RESTful API 时特别有用，因为它允许开发人员详细控制 HTTP 响应的各个方面。

### `ResponseEntity` 类概述

**`ResponseEntity`** 位于 `org.springframework.http` 包中。它的设计目的是封装 HTTP 响应的所有部分，提供更强大的控制能力。这个类具有几个主要功能：

1. **设置 HTTP 状态码**：允许你指定响应的 HTTP 状态码，例如 200 OK、404 Not Found、500 Internal Server Error 等。
2. **设置响应头**：可以添加自定义的 HTTP 响应头。
3. **设置响应体**：允许你设置响应的内容，可以是任意对象或数据。

### 常用方法

1. **静态工厂方法**

   - **`ResponseEntity.ok()`**：
     - 返回一个 HTTP 状态码为 200 OK 的 `ResponseEntity` 对象。可以使用链式方法设置响应体。
   
   - **`ResponseEntity.badRequest()`**：
     - 返回一个 HTTP 状态码为 400 Bad Request 的 `ResponseEntity` 对象。

   - **`ResponseEntity.notFound()`**：
     - 返回一个 HTTP 状态码为 404 Not Found 的 `ResponseEntity` 对象。

   - **`ResponseEntity.status(HttpStatus status)`**：
     - 返回一个指定状态码的 `ResponseEntity` 对象。可以通过链式方法设置响应体和响应头。

2. **构造方法**

   - **`ResponseEntity(T body, HttpStatus status)`**：
     - 创建一个包含指定响应体和状态码的 `ResponseEntity` 对象。
   
   - **`ResponseEntity(T body, HttpHeaders headers, HttpStatus status)`**：
     - 创建一个包含指定响应体、响应头和状态码的 `ResponseEntity` 对象。

3. **设置响应头**

   - **`ResponseEntity.headers(HttpHeaders headers)`**：
     - 设置响应头。可以通过链式方法来指定。

4. **获取方法**

   - **`getStatusCode()`**：
     - 返回 `ResponseEntity` 的 HTTP 状态码。

   - **`getHeaders()`**：
     - 返回 `ResponseEntity` 的 HTTP 头信息。

   - **`getBody()`**：
     - 返回 `ResponseEntity` 的响应体。

### 示例代码

以下是使用 `ResponseEntity` 的一些示例：

**示例 1: 简单的成功响应**```

@RestController
public class MyController {

    @GetMapping("/success")
    public ResponseEntity<String> getSuccess() {
        String responseBody = "Operation was successful!";
        return ResponseEntity.ok(responseBody);
    }
}

```

**示例 2: 带自定义状态码和头的响应**```

@RestController
public class MyController {

    @GetMapping("/custom")
    public ResponseEntity<String> getCustomResponse() {
        HttpHeaders headers = new HttpHeaders();
        headers.add("Custom-Header", "CustomValue");
        String responseBody = "Custom response with headers!";
        return ResponseEntity.status(HttpStatus.CREATED)
                             .headers(headers)
                             .body(responseBody);
    }
}

**示例 3: 错误响应**```java

@RestController
public class MyController {

    @GetMapping("/error")
    public ResponseEntity<String> getError() {
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
                             .body("An error occurred!");
    }
}

```

### 重要概念

- **泛型支持**：`ResponseEntity` 是一个泛型类，可以封装任何类型的响应体。`ResponseEntity<T>` 使得可以创建类型安全的响应体。
- **链式调用**：通过链式调用，你可以设置状态码、响应头和响应体，形成更清晰的 API。

### 总结

`ResponseEntity` 类提供了一种灵活和强大的方式来构建和管理 HTTP 响应。无论是成功响应还是错误响应，它都允许你详细控制响应的各个方面。理解和正确使用 `ResponseEntity` 是构建健壮 RESTful API 的关键。