Acme PostURLConnection 源碼深度解析：手工構建 HTTP POST 請求

前言：為何需要自製 POST 連線類？

早期瀏覽器（如 Navigator 3.0）的 URLConnection 不支援 POST 方法。Acme 套件提供 PostURLConnection 作為替代方案，雖現代環境已無此需求，但其源碼展示了 HTTP/1.0 協議底層交互細節，是理解 Socket 程式設計、HTTP 協議構造的優秀教材。

核心架構設計

public class PostURLConnection {
    private URL url;
    private boolean doInput = false;
    private boolean doOutput = true;  // 預設支援輸出（POST）
    private boolean useCaches = false;
    
    private Vector reqHeaderNames = new Vector();
    private Vector reqHeaderValues = new Vector();
    private Vector resHeaderNames, resHeaderValues;
    
    private Socket socket;
    private OutputStream out;
    private InputStream in;
    private boolean connected = false;
    private boolean inputStarted = false;
}

關鍵流程深度剖析

1. connect()：建立 Socket 連線並發送請求頭

• 檢查快取策略，非快取模式加入 "Pragma: no-cache"
• 解析 URL：協議必須為 HTTP，預設埠號 80
• 建立 Socket 連線，取得 OutputStream
• 構造請求行：POST /path HTTP/1.0
• 遍歷寫入請求頭（Header）
• 空行結束頭部，flush 發送

2. startInput()：解析回應頭

• 呼叫 connect() 確保已連線
• 取得 InputStream，包裝為 DataInputStream
• 讀取並忽略狀態行（HTTP/1.0 200 OK）
• 循環讀取頭部行，遇空行結束
• 解析 "Name: Value" 格式，存入向量（名稱轉小寫）

3. getOutputStream() / getInputStream()：雙向資料通道

• getOutputStream()：確保 doOutput=true，呼叫 connect() 返回請求輸出流，供寫入 POST Body
• getInputStream()：確保 doInput=true，呼叫 startInput() 解析完頭部後返回回應輸入流

4. 完整 HTTP 客戶端介面實作

類實作 URLConnection 核心契約方法：

• getHeaderField()、getHeaderFieldInt()、getHeaderFieldDate()：頭部存取
• getContentLength()、getContentType()：內容元資料
• setRequestProperty() / getRequestProperty()：請求頭管理
• setDoInput/Output()、setUseCaches()：連線配置（連線前可設）
• close()：關閉輸出/輸入流與 Socket

設計亮點與局限

現代替代方案

生產環境建議使用：

• Java 11+ java.net.http.HttpClient（標準庫、非同步、HTTP/2）
• Apache HttpClient 5.x（成熟、連線池、完整協議支援）
• OkHttp / Retrofit（Android/主流首選、介面優雅）

總結

PostURLConnection 是 HTTP 協議手工構建的經典範例。研讀其源碼能深入理解：請求/回應格式、頭部解析、流雙向通訊、資源生命週期管理。雖已過時，但作為「拆解 HTTP 黑盒」的教具價值永存。