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 。