4. 基本方法

為了有效地管理 Java 應用程序中的 HTTP 狀態碼，我們可以定義一個 枚舉，其中封裝了所有標準 HTTP 狀態碼及其描述。

這種方法允許我們利用 枚舉 的優勢，例如類型安全和代碼清晰度。讓我們首先定義 HttpStatus 枚舉：

public enum HttpStatus {
    CONTINUE(100, "Continue"),
    SWITCHING_PROTOCOLS(101, "Switching Protocols"),
    OK(200, "OK"),
    CREATED(201, "Created"),
    ACCEPTED(202, "Accepted"),
    MULTIPLE_CHOICES(300, "Multiple Choices"),
    MOVED_PERMANENTLY(301, "Moved Permanently"),
    FOUND(302, "Found"),
    BAD_REQUEST(400, "Bad Request"),
    UNAUTHORIZED(401, "Unauthorized"),
    FORBIDDEN(403, "Forbidden"),
    NOT_FOUND(404, "Not Found"),
    INTERNAL_SERVER_ERROR(500, "Internal Server Error"),
    NOT_IMPLEMENTED(501, "Not Implemented"),
    BAD_GATEWAY(502, "Bad Gateway"),
    UNKNOWN(-1, "Unknown Status");

    private final int code;
    private final String description;

    HttpStatus(int code, String description) {
        this.code = code;
        this.description = description;
    }

    public static HttpStatus getStatusFromCode(int code) {
        for (HttpStatus status : HttpStatus.values()) {
            if (status.getCode() == code) {
                return status;
            }
        }
        return UNKNOWN;
    }

    public int getCode() {
        return code;
    }

    public String getDescription() {
        return description;
    }
}

此常量中的每個 枚舉 常量都與整數代碼和字符串描述相關聯。 此外，構造函數初始化這些值，並且我們提供 getter 方法以檢索它們。

讓我們創建單元測試以確保 HttpStatus 枚舉 類正常工作：

@Test
public void givenStatusCode_whenGetCode_thenCorrectCode() {
    assertEquals(100, HttpStatus.CONTINUE.getCode());
    assertEquals(200, HttpStatus.OK.getCode());
    assertEquals(300, HttpStatus.MULTIPLE_CHOICES.getCode());
    assertEquals(400, HttpStatus.BAD_REQUEST.getCode());
    assertEquals(500, HttpStatus.INTERNAL_SERVER_ERROR.getCode());
}

@Test
public void givenStatusCode_whenGetDescription_thenCorrectDescription() {
    assertEquals("Continue", HttpStatus.CONTINUE.getDescription());
    assertEquals("OK", HttpStatus.OK.getDescription());
    assertEquals("Multiple Choices", HttpStatus.MULTIPLE_CHOICES.getDescription());
    assertEquals("Bad Request", HttpStatus.BAD_REQUEST.getDescription());
    assertEquals("Internal Server Error", HttpStatus.INTERNAL_SERVER_ERROR.getDescription());
}

在此，我們驗證 getCode() 和 getDescription() 方法返回各種 HTTP 狀態碼的正確值。 第一個測試方法檢查 getCode() 方法返回 枚舉 常量的正確整數代碼。 類似地，第二個測試方法確保 getDescription() 方法返回適當的字符串描述。

5. 使用 Apache HttpComponents

Apache HttpComponents 是一個流行的 HTTP 通信庫。為了使用它與 Maven 集成，我們在 pom.xml 中包含以下依賴項：

<dependency>
    <groupId>org.apache.httpcomponents.client5</groupId>
    <artifactId>httpclient5</artifactId>
    <version>5.3.1</version>
</dependency>

我們可以在 Maven Central 找到有關此依賴項的更多詳細信息。

我們可以使用我們的 HttpStatus 枚舉 來處理 HTTP 響應：

@Test
public void givenHttpRequest_whenUsingApacheHttpComponents_thenCorrectStatusDescription() throws IOException {
    CloseableHttpClient httpClient = HttpClients.createDefault();
    HttpGet request = new HttpGet("http://example.com");
    try (CloseableHttpResponse response = httpClient.execute(request)) {
        String reasonPhrase = response.getStatusLine().getReasonPhrase();
        assertEquals("OK", reasonPhrase);
    }
}

在這裏，我們首先使用 createDefault() 方法創建一個 CloseableHttpClient 實例。 此外，此客户端負責執行 HTTP 請求。 然後，我們使用 new HttpGet(“http://example.com”)構造一個 HTTP GET 請求到 http://example.com。 通過使用 execute() 方法執行請求，我們收到一個 CloseableHttpResponse 對象。

從此響應中，我們使用 response.getStatusLine().getStatusCode()提取狀態碼。 然後，我們使用 HttpStatusUtil.getStatusDescription()檢索與狀態碼關聯的狀態描述。

最後，我們使用 assertEquals()來確保描述與預期值匹配，驗證我們的狀態碼處理的準確性。

6. 使用 RestTemplate 框架

Spring Framework 的 RestTemplate 也可以從我們的 HttpStatus 枚舉 中受益，用於處理 HTTP 響應。首先，讓我們在我們的 pom.xml 中包含以下依賴項：

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-web</artifactId>
    <version>6.1.11</version>
</dependency>

@Test
public void givenHttpRequest_whenUsingSpringRestTemplate_thenCorrectStatusDescription() {
    RestTemplate restTemplate = new RestTemplate();
    ResponseEntity<String> response = restTemplate.getForEntity("http://example.com", String.class);
    int statusCode = response.getStatusCode().value();
    String statusDescription = HttpStatus.getStatusFromCode(statusCode).getDescription();
    assertEquals("OK", statusDescription);
}

<dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp</artifactId>
    <version>4.12.0</version>
</dependency>

@Test
public void givenHttpRequest_whenUsingOkHttp_thenCorrectStatusDescription() throws IOException {
    OkHttpClient client = new OkHttpClient();
    Request request = new Request.Builder()
      .url("http://example.com")
      .build();
    try (Response response = client.newCall(request).execute()) {
        int statusCode = response.code();
        String statusDescription = HttpStatus.getStatusFromCode(statusCode).getDescription();
        assertEquals("OK", statusDescription);
    }
}