萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> JSP 程式設計

JSP 讀寫 Cookie 實務教學(含完整程式碼與避坑指南)

Cookie 是 Web 早期解決 HTTP 無狀態問題的關鍵技術,至今仍廣泛用於用戶識別、偏好記憶等場景。本文提供完整的 JSP 寫入與讀取範例,並深入解析版本相容性與字元限制等實務細節。

一、寫入 Cookie:建立與送出

<html>
<head><title>寫入 Cookie 範例</title></head>
<body>
<%
  String cookieName = "Sender";
  Cookie cookie = new Cookie(cookieName, "Test_Content");
  cookie.setMaxAge(10); // 10 秒後過期
  response.addCookie(cookie);
%>
<p>Cookie 已寫入,名稱為「Sender」,值為「Test_Content」,存活 10 秒。</p>
</body>
</html>

程式碼逐行解析

  1. new Cookie(name, value):建立 Cookie 物件,名稱與值皆為字串。
  2. setMaxAge(秒數):設定存活期。正數 = 持久 Cookie(寫入硬碟);0 = 立即刪除;負數 = Session Cookie(瀏覽器關閉即失效,預設值)。
  3. response.addCookie(cookie):將 Cookie 加入 HTTP 回應標頭,送達客戶端。

二、讀取 Cookie:遍歷與解析

<html>
<head><title>讀取 Cookie 範例</title></head>
<body>
<table border="1">
  <tr><th>Cookie 名稱</th><th>Cookie 內容</th></tr>
<%
  Cookie[] cookies = request.getCookies();
  if (cookies != null) {
    for (int i = 0; i < cookies.length; i++) {
      Cookie c = cookies[i];
      String cName = c.getName();
      String cValue = c.getValue();
%>
  <tr><td><%= cName %></td><td><%= cValue %></td></tr>
<%
    }
  }
%>
</table>
</body>
</html>

關鍵步驟

  1. request.getCookies() 取得所有有效 Cookie 陣列(若無則為 null)。
  2. 迴圈遍歷陣列,逐一取出 Cookie 物件。
  3. 使用 getName()、getValue() 取得名稱與值,可存入變數進一步邏輯判斷。

三、實務必知的兩大限制

1. Cookie 版本相容性

  • Version 0 (Netscape 規範):幾乎所有瀏覽器支援,Java javax.servlet.http.Cookie 僅支援此版本。
  • Version 1 (RFC 2109):功能增強,但 Java 標準庫不支援,亦未被所有瀏覽器完整實作。
  • 結論:開發時請以 Version 0 為基準,避免使用新版特有功能。

2. Cookie 值字元限制(Version 0)

以下字元禁止直接出現在 Cookie 值中:

空格、[]、()、=、,、"、/、?、@、:、;

範例使用 "Test_Content" 即為避開特殊字元。若必須包含上述字元,建議自行進行 URLEncoder.encode() 編碼存入,讀取時 URLDecoder.decode() 還原。

四、最佳實務建議

  • 敏感資料勿直接存入 Cookie,應存放 Session ID 或加密 Token。
  • 設定 HttpOnly 屬性防止 XSS 攻擊(需 Servlet 3.0+ 或手動設定 Header)。
  • 跨子網域共享 Cookie 時,正確設定 Domain 與 Path 屬性。
copyright © 萬盛學電腦網 all rights reserved