Cookie 是伺服器發送給瀏覽器的小段文本,瀏覽器自動攜帶於後續請求中,用於會話追蹤、個性化偏好、記憶登入等。JSP 通過 `response.addCookie()` 寫入、`request.getCookies()` 讀取。
<%
String cookieName = "username";
String cookieValue = "zhangsan";
Cookie cookie = new Cookie(cookieName, cookieValue);
cookie.setMaxAge(60 * 60 * 24 * 7); // 7 天有效,秒為單位;-1 為會話級;0 為刪除
cookie.setPath("/"); // 生效路徑,默認當前路徑
cookie.setDomain(".example.com"); // 跨子域共享,可選
cookie.setSecure(true); // 僅 HTTPS 傳輸
cookie.setHttpOnly(true); // 防 XSS,JS 無法讀取
response.addCookie(cookie);
%>
<%
Cookie[] cookies = request.getCookies();
if (cookies != null) {
for (Cookie c : cookies) {
String name = c.getName();
String value = c.getValue();
out.println(name + " = " + value + "<br>");
// 取特定 Cookie
if ("username".equals(name)) {
// 使用 value
}
}
}
%>
| 屬性 | 方法 | 說明 |
|---|---|---|
| 名稱/值 | 構造函數 | 標識與數據,值不含空格、分號、逗號等特殊字符(V0 規範) |
| Max-Age | setMaxAge(int 秒) | >0 持久化;=0 刪除;<0 會話級(瀏覽器關閉失效) |
| Path | setPath(String) | URL 路徑前綴匹配,默認當前 Servlet 路徑 |
| Domain | setDomain(String) | 域名後綴匹配,如 `.example.com` 覆蓋所有子域 |
| Secure | setSecure(boolean) | true 時僅 HTTPS 傳輸 |
| HttpOnly | setHttpOnly(boolean) | true 禁止 JS 訪問,防 XSS 竊取 |
建議:堅持使用 V0 格式,值提前 `URLEncoder.encode`,讀取後 `URLDecoder.decode`,確保兼容性。