Java - HttpURLConnection 類別

引言

嘿，未來的 Java 巫師們！? 今天，我們將要進入 HttpURLConnection 的神奇世界。別擔心如果你之前從未寫過一行代碼——我會成為你這次興奮旅程中的友好導遊。在這個教學的結束時，你將會像專業人士一樣發送 HTTP 請求！

HttpURLConnection 是什麼？

想像你是一名郵差，你的工作是網際網路上不同電腦之間傳遞訊息。這就是 HttpURLConnection 的本質！它是一個內置的 Java 類別，幫助我們的程序與網絡伺服器進行通信，讓我們能夠發送請求和接收回應。

我們為什麼需要 HttpURLConnection？

在今日相互連接的世界中，應用程序經常需要透過網絡互相通信。無論你是正在構建一個需要獲取預報數據的天氣應用程序，還是一個發布更新信息的社交媒體客戶端，HttpURLConnection 是你處理這些網絡交互的可靠助手。

開始使用

讓我們從一個簡單的例子開始，熱熱身：

import java.net.HttpURLConnection;
import java.net.URL;
import java.io.BufferedReader;
import java.io.InputStreamReader;

public class SimpleHttpExample {
public static void main(String[] args) {
try {
URL url = new URL("https://api.example.com/greeting");
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("GET");

int responseCode = connection.getResponseCode();
System.out.println("回應代碼: " + responseCode);

BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()));
String inputLine;
StringBuilder response = new StringBuilder();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();

System.out.println("回應: " + response.toString());

} catch (Exception e) {
e.printStackTrace();
}
}
}

讓我們一步一步分解這段代碼：

1. 我們從導入必要的類別開始。
2. 我們創建一個 URL 對象，並設置我們想要連接到地址。
3. 我們使用 url.openConnection() 打開連接，並將其轉換為 HttpURLConnection。
4. 我們設置請求方法為 "GET"（稍後會詳細介紹）。
5. 我們發送請求並獲取回應代碼。
6. 我們逐行讀取回應內容並將其存儲在 StringBuilder 中。
7. 最後，我們打印出回應。

HTTP 方法

記得我們將請求方法設置為 "GET" 嗎？實際上有幾種 HTTP 方法我們可以使用。可以把這些看作是我們可以向伺服器提出的不同類型的問題：

• GET: "嘿，伺服器，你能給我一些信息嗎？"
• POST: "嗨，伺服器，這裡有一些信息給你處理。"
• PUT: "你好，伺服器，請更新這些現有的信息。"
• DELETE: "對不起，伺服器，你能刪除這些信息嗎？"

讓我們看看如何使用不同的方法：

HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("POST");
connection.setDoOutput(true);

在這裡，我們設置了一個 POST 請求，並啟用了輸出（因為我們要向伺服器發送數據）。

添加請求頭

有時候，我們需要與請求一起發送額外信息。我們可以使用頭部信息來做到這點：

connection.setRequestProperty("Content-Type", "application/json");
connection.setRequestProperty("Authorization", "Bearer mytoken123");

這就像是在你的訊息上附加一張便條，給伺服器提供更多關於你的請求的上下文。

使用 POST 請求發送數據

當我們想要向伺服器發送數據（如提交表單）時，我們使用 POST 請求：

String postData = "name=John&age=30";
try (OutputStream os = connection.getOutputStream()) {
byte[] input = postData.getBytes("utf-8");
os.write(input, 0, input.length);
}

把這想像成填寫一張表單並點擊提交按鈕！

處理回應

我們已經看到了如何將回應讀作文本，但有時伺服器會返回不同類型的數據。讓我們看看如何處理 JSON 回應：

import org.json.JSONObject;

// ... (連接設置代碼)

BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
StringBuilder response = new StringBuilder();
String line;
while ((line = reader.readLine()) != null) {
response.append(line);
}
reader.close();

JSONObject jsonResponse = new JSONObject(response.toString());
String name = jsonResponse.getString("name");
int age = jsonResponse.getInt("age");

System.out.println("姓名: " + name + "，年齡: " + age);

在這裡，我們解析 JSON 回應並提取特定字段。就像打開一個包裹並找到你需要的東西！

錯誤處理

當然，在網絡上並非一切總是一帆風順。讓我們看看如何處理錯誤：

if (connection.getResponseCode() >= 300) {
System.out.println("錯誤: " + connection.getResponseCode() + " " + connection.getResponseMessage());
InputStream errorStream = connection.getErrorStream();
// 讀取並處理錯誤回應
} else {
// 處理成功的回應
}

這就像檢查你的訊息是否成功送達，如果沒有，找出問題所在。

HttpURLConnection 方法

以下是一些重要的 HttpURLConnection 方法的快速參考表：

方法	描述
setRequestMethod(String)	設置 HTTP 方法（GET、POST 等。）
setRequestProperty(String, String)	添加請求頭部
getResponseCode()	獲取 HTTP 回應狀態碼
getInputStream()	獲取讀取回應的輸入流
getErrorStream()	獲取請求失敗時的錯誤流
disconnect()	關閉連接

結論

恭喜你！你剛剛踏入了 Java 網絡通信的世界。HttpURLConnection 看起來可能有些複雜，但隨著練習，你會發現它是你編程工具箱中的一個非常強大的工具。

記住，網絡就像一片信息的廣闊海洋，HttpURLConnection 是你穩健的船，讓你能在其中航行。繼續探索，繼續練習，很快你就能輕鬆地處理網絡請求！

祝你編程愉快，未來的 Java 大師們！??‍??‍?

Credits: Image by storyset