JSP Cookie 處理
Cookie 是存儲在客戶機的文本檔,它們保存了大量軌跡資訊。在 Servlet 技術基礎上,JSP 顯然能夠提供對 HTTP cookie 的支持。
通常有三個步驟來識別回頭客:
- 伺服器腳本發送一系列 cookie 至流覽器。比如名字,年齡,ID 號碼等等。
- 流覽器在本地機中存儲這些資訊,以備不時之需。
- 當下一次流覽器發送任何請求至伺服器時,它會同時將這些 cookie 資訊發送給伺服器,然後伺服器使用這些資訊來識別用戶或者幹些其他事情。
本章節將會傳授您如何去設置或重設 cookie 的方法,還有如何訪問它們及如何刪除它們。
JSP Cookie 處理需要對中文進行編碼與解碼,方法如下:
String str = java.net.URLEncoder.encode("中文", "UTF-8"); //編碼 String str = java.net.URLDecoder.decode("編碼後的字串","UTF-8"); // 解碼
Cookie 剖析
Cookie 通常在 HTTP 資訊頭中設置(雖然 JavaScript 能夠直接在流覽器中設置 cookie)。在 JSP 中,設置一個 cookie 需要發送如下的資訊頭給伺服器:
HTTP/1.1 200 OK Date: Fri, 04 Feb 2015 21:03:38 GMT Server: Apache/1.3.9 (UNIX) PHP/4.0b3 Set-Cookie: name=zaixian; expires=Friday, 04-Feb-17 22:03:38 GMT; path=/; domain=xuhuhu.com Connection: close Content-Type: text/html
正如您所見,Set-Cookie 資訊頭包含一個鍵值對,一個 GMT(格林尼治標准)時間,一個路徑,一個功能變數名稱。鍵值對會被編碼為URL。有效期域是個指令,告訴流覽器在什麼時候之後就可以清除這個 cookie。
如果流覽器被配置成可存儲 cookie,那麼它將會保存這些資訊直到過期。如果用戶訪問的任何頁面匹配了 cookie 中的路徑和功能變數名稱,那麼流覽器將會重新將這個 cookie 發回給伺服器。流覽器端的資訊頭長得就像下麵這樣:
GET / HTTP/1.0 Connection: Keep-Alive User-Agent: Mozilla/4.6 (X11; I; Linux 2.2.6-15apmac ppc) Host: zink.demon.co.uk:1126 Accept: image/gif, */* Accept-Encoding: gzip Accept-Language: en Accept-Charset: iso-8859-1,*,utf-8 Cookie: name=xyz
JSP 腳本通過 request 對象中的 getCookies() 方法來訪問這些 cookie,這個方法會返回一個 Cookie 對象的數組。
Servlet Cookie 方法
下表列出了 Cookie 對象中常用的方法:
序號 | 方法 & 描述 |
---|---|
1 | public void setDomain(String pattern) 設置 cookie 的功能變數名稱,比如 xuhuhu.com |
2 | public String getDomain() 獲取 cookie 的功能變數名稱,比如 xuhuhu.com |
3 | public void setMaxAge(int expiry) 設置 cookie 有效期,以秒為單位,默認有效期為當前session的存活時間 |
4 | public int getMaxAge() 獲取 cookie 有效期,以秒為單位,默認為-1 ,表明cookie會活到流覽器關閉為止 |
5 | public String getName() 返回 cookie 的名稱,名稱創建後將不能被修改 |
6 | public void setValue(String newValue) 設置 cookie 的值 |
7 | public String getValue() 獲取cookie的值 |
8 | public void setPath(String uri) 設置 cookie 的路徑,默認為當前頁面目錄下的所有 URL,還有此目錄下的所有子目錄 |
9 | public String getPath() 獲取 cookie 的路徑 |
10 | public void setSecure(boolean flag) 指明 cookie 是否要加密傳輸 |
11 | public void setComment(String purpose) 設置注釋描述 cookie 的目的。當流覽器將 cookie 展現給用戶時,注釋將會變得非常有用 |
12 | public String getComment() 返回描述 cookie 目的的注釋,若沒有則返回 null |
使用 JSP 設置 cookie
使用 JSP 設置 cookie 包含三個步驟:
(1)創建一個 cookie 對象: 調用 cookie 的構造函數,使用一個 cookie 名稱和值做參數,它們都是字串。
Cookie cookie = new Cookie("key","value");
請務必牢記,名稱和值中都不能包含空格或者如下的字元:
[ ] ( ) = , " / ? @ : ;
(2) 設置有效期:調用 setMaxAge() 函數表明 cookie 在多長時間(以秒為單位)內有效。下麵的操作將有效期設為了 24 小時。
cookie.setMaxAge(60*60*24);
(3) 將 cookie 發送至 HTTP 回應頭中:調用 response.addCookie() 函數來向 HTTP 回應頭中添加 cookie。
response.addCookie(cookie);
實例演示
main.jsp 檔代碼如下所示:
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@ page import="java.net.*" %> <% // 編碼,解決中文亂碼 String str = URLEncoder.encode(request.getParameter("name"),"utf-8"); // 設置 name 和 url cookie Cookie name = new Cookie("name", str); Cookie url = new Cookie("url", request.getParameter("url")); // 設置cookie過期時間為24小時。 name.setMaxAge(60*60*24); url.setMaxAge(60*60*24); // 在回應頭部添加cookie response.addCookie( name ); response.addCookie( url ); %> <html> <head> <title>設置 Cookie</title> </head> <body> <h1>設置 Cookie</h1> <ul> <li><p><b>網站名:</b> <%= request.getParameter("name")%> </p></li> <li><p><b>網址:</b> <%= request.getParameter("url")%> </p></li> </ul> </body> </html>
以下是一個簡單的 HTML 表單通過 GET 方法將客戶端數據提交到 main.jsp 檔中,並設置 cookie:
<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>IT研修(xuhuhu.com)</title> </head> <body> <form action="main.jsp" method=GET> 站點名: <input type="text" name="name"> <br /> 網址: <input type="text" name="url" /> <input type="submit" value="提交" /> </form> </body> </html>
將以上 HTML 代碼保存到 test.htm 檔中。
將該檔放置於當前 jsp 專案的 WebContent 目錄下(與 main.jsp 同一個目錄)。
通過訪問 http://localhost:8080/testjsp/test.html 提交表單數據到 main.jsp 檔,演示 Gif 圖如下所示:
試著輸入 "站點名" 和 "網址",然後點擊提交按鈕,它將會在您的螢幕中顯示 "站點名" 和 "網址",並且設置 "站點名" 和 "網址" 的兩個 cookie。
使用 JSP 讀取 Cookie
想要讀取 cookie,您就需要調用 request.getCookies() 方法來獲得一個 javax.servlet.http.Cookie 對象的數組,然後遍曆這個數組,使用 getName() 方法和 getValue() 方法來獲取每一個 cookie 的名稱和值。
讓我們來讀取上個例子中的cookie, 以下為 cookie.jsp 檔代碼:
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@ page import="java.net.*" %> <!DOCTYPE html> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>獲取 Cookie</title> </head> <body> <% Cookie cookie = null; Cookie[] cookies = null; // 獲取 cookies 的數據,是一個數組 cookies = request.getCookies(); if( cookies != null ){ out.println("<h2> 查找 Cookie 名與值</h2>"); for (int i = 0; i < cookies.length; i++){ cookie = cookies[i]; out.print("參數名 : " + cookie.getName()); out.print("<br>"); out.print("參數值: " + URLDecoder.decode(cookie.getValue(), "utf-8") +" <br>"); out.print("------------------------------------<br>"); } }else{ out.println("<h2>沒有發現 Cookie</h2>"); } %> </body> </html>
流覽器訪問後,輸出結果為:
使用 JSP 刪除 cookie
刪除 cookie 非常簡單。如果您想要刪除一個 cookie,按照下麵給的步驟來做就行了:
- 獲取一個已經存在的 cookie 然後存儲在 Cookie 對象中。
- 將 cookie 的有效期設置為 0。
- 將這個 cookie 重新添加進回應頭中。
實例演示
下麵的程式刪除一個名為 "name" 的 cookie,當您第二次運行 cookie.jsp時,name 將會為 null。
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@ page import="java.net.*" %> <!DOCTYPE html> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>獲取 Cookie</title> </head> <body> <% Cookie cookie = null; Cookie[] cookies = null; // 獲取當前功能變數名稱下的cookies,是一個數組 cookies = request.getCookies(); if( cookies != null ){ out.println("<h2> 查找 Cookie 名與值</h2>"); for (int i = 0; i < cookies.length; i++){ cookie = cookies[i]; if((cookie.getName( )).compareTo("name") == 0 ){ cookie.setMaxAge(0); response.addCookie(cookie); out.print("刪除 Cookie: " + cookie.getName( ) + "<br/>"); } out.print("參數名 : " + cookie.getName()); out.print("<br>"); out.print("參數值: " + URLDecoder.decode(cookie.getValue(), "utf-8") +" <br>"); out.print("------------------------------------<br>"); } }else{ out.println("<h2>沒有發現 Cookie</h2>"); } %> </body> </html>
通過流覽器訪問,輸出結果為:
再次訪問 http://localhost:8080/testjsp/cookie.jsp,將會得到如下結果:
可以看到名為 "name" 的 cookie 已經不見了。
您也可以手動在流覽器中刪除 cookie。IE 流覽器通過點擊 Tools 菜單項,然後選擇 Internet Options,點擊 Delete Cookies,就能刪除所有 cookie 。