萬盛學電腦網

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

JSP 讀寫 Cookie 完整指南:建立、讀取、屬性設定與注意事項

Cookie 基本概念

Cookie 是伺服器發送至瀏覽器的小型文字資料,瀏覽器儲存並於後續請求自動攜帶。常用於會話追蹤、個人化偏好、記住登入等。

寫入 Cookie(伺服器 → 瀏覽器)

<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>
<%
  // 1. 建立 Cookie:名稱、值
  Cookie cookie = new Cookie("userName", "JohnDoe");
  
  // 2. 設定屬性
  cookie.setMaxAge(60 * 60 * 24 * 30); // 存活 30 天(秒),負數=會話級,0=刪除
  cookie.setPath("/");                 // 生效路徑,預設為當前請求路徑
  cookie.setDomain(".example.com");    // 生效域名,支援子域名共享(可選)
  cookie.setSecure(true);              // 僅 HTTPS 傳輸(生產環境建議開啟)
  cookie.setHttpOnly(true);            // 禁止 JS 存取,防 XSS 竊取(需 Servlet 3.0+)
  // cookie.setComment("用戶識別");     // 描述(舊版用)
  
  // 3. 寫入回應
  response.addCookie(cookie);
%>
<html><body>Cookie 已寫入</body></html>

讀取 Cookie(瀏覽器 → 伺服器)

<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>
<%
  Cookie[] cookies = request.getCookies(); // 取得所有 Cookie 陣列
  String userName = null;
  
  if (cookies != null) {
    for (Cookie c : cookies) {
      if ("userName".equals(c.getName())) {
        userName = c.getValue();
        break;
      }
    }
  }
%>
<html><body>
  <h3>歡迎回來,<%= (userName != null ? userName : "訪客") %></h3>
  <table border="1">
    <tr><th>Cookie 名稱</th><th>Cookie 值</th></tr>
    <%
      if (cookies != null) {
        for (Cookie c : cookies) {
    %>
    <tr><td><%= c.getName() %></td><td><%= c.getValue() %></td></tr>
    <% } } %>
  </table>
</body></html>

Cookie 核心屬性詳細說明

屬性方法說明範例
Name建構子識別名稱,不可修改new Cookie("sid", "abc")
Value建構子 / setValue()儲存資料,**不可含分號、逗號、空白、等號**等特殊字元URLEncoder.encode("中文", "UTF-8")
MaxAgesetMaxAge(int 秒)存活秒數:>0 持久化、=0 刪除、<0 會話級(關閉瀏覽器失效)30天: 60*60*24*30
PathsetPath(String)URL 路徑前綴匹配,**預設為建立 Cookie 的請求路徑**,建議設 //app/, /
DomainsetDomain(String)域名匹配,.example.com 含子域名,**不可跨主域名設定**.example.com
SecuresetSecure(boolean)僅 HTTPS 傳輸,防竊聽true (生產環境)
HttpOnlysetHttpOnly(boolean)禁止 JavaScript document.cookie 存取,防 XSStrue (敏感 Cookie)
SameSitesetAttribute("SameSite", "Strict/Lax/None")防 CSRF:Strict(同站)、Lax(部分鏈接)、None(跨站需 Secure)Lax (預設)

實用工具類

public class CookieUtil {
  public static void addCookie(HttpServletResponse resp, String name, String value, int maxAge) {
    Cookie c = new Cookie(name, value);
    c.setMaxAge(maxAge);
    c.setPath("/");
    c.setHttpOnly(true);
    c.setSecure(true); // 僅 HTTPS 環境
    resp.addCookie(c);
  }
  
  public static String getCookie(HttpServletRequest req, String name) {
    Cookie[] cookies = req.getCookies();
    if (cookies != null) {
      for (Cookie c : cookies) if (name.equals(c.getName())) return c.getValue();
    }
    return null;
  }
  
  public static void removeCookie(HttpServletResponse resp, String name) {
    Cookie c = new Cookie(name, "");
    c.setMaxAge(0);
    c.setPath("/");
    resp.addCookie(c);
  }
}

關鍵注意事項

  1. 版本相容性:Java javax.servlet.http.Cookie 僅支援 Version 0 (Netscape 規範)。Version 1 (RFC 2109) 新增 Comment、Port、CommentURL 等屬性,**Java 標準庫不支援**,需自行解析 Header。
  2. 值編碼限制:Cookie 值不可含 ; , = 空白 " ' / ? @ : [ ]。中文/特殊字元**必須 URLEncoder.encode()**,讀取時 URLDecoder.decode()。
  3. 大小限制:單個 Cookie ≤ 4KB,單域名總數 ≤ 20-50 個(瀏覽器差異)。大數據請用 localStorage/Session/資料庫。
  4. 安全性:敏感資料(Session ID、Token)**必須**設定 HttpOnly=true, Secure=true, SameSite=Strict/Lax。
  5. 路徑陷阱:setPath("/app") 僅在 /app/* 送出,/other 不送。統一用 / 避免遺漏。

現代替代方案

方案容量自動攜帶適用場景
Cookie4KB是 (HTTP Header)Session ID、CSRF Token、追蹤 ID
localStorage5-10MB否 (JS 手動)用戶偏好、離線快取、大型客戶端狀態
sessionStorage5-10MB否單標籤頁臨時資料
IndexedDB數百 MB否結構化離線資料、PWA
JWT (Header/Body)無限制由前端控制無狀態認證、微服務授權
copyright © 萬盛學電腦網 all rights reserved