JSP的Cookie处理
以下内容引用自http://wiki.jikexueyuan.com/project/jsp/Cookies-handling.html:
Cookies是存储在客户端计算机的文本文件,保存各种跟踪目标的信息。JSP使用底层Servlet技术透明地支持HTTP Cookies。
确定返回用户有三个步骤:
-
服务器脚本向浏览器发送的一系列Cookies。例如姓名、年龄、身份证号码等。
-
浏览器将这个信息存储在本地机器上,以供将来使用。
- 下次当浏览器向Web服务器发送任何请求时,将这些Cookies信息发送给服务器,服务器使用这些信息来识别用户或可能用于其他目的。
一、Cookie的剖析
Cookie通常设置在一个HTTP标题中(尽管JavaScript也可以在浏览器中直接设置Cookie)。设置Cookie的JSP可能发送如下所示的标题信息:
HTTP/1.1 200 OK
Date: Fri, 04 Feb 2000 21:03:38 GMT
Server: Apache/1.3.9 (UNIX) PHP/4.0b3
Set-Cookie: name=xyz; expires=Friday, 04-Feb-07 22:03:38 GMT;
path=/; domain=tutorialspoint.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
二、Servlet Cookies方法
下面是与Cookie对象关联的有用的方法列表,可以在JSP中操作Cookies时使用:
方法 | 描述 |
---|---|
public void setDomain(String pattern) |
此方法设置了Cookie适用的领域,例如jsoft.com。 |
public String getDomain() |
此方法得到了Cookie适用的领域,例如jsoft.com。 |
public void setMaxAge(int expiry) |
该方法设置了在Cookie到期之前需要多少时间(以秒为单位)。如果不设置这个,Cookie只持续到当前会话。 |
public int getMaxAge() |
该方法返回了最大持续时间的Cookie,以秒为单位指定,默认情况下,-1表示Cookie会持续到浏览器关闭。 |
public String getName() |
该方法将返回Cookie的名称。这个名字创建后不能更改。 |
public void setValue(String newValue) |
这个方法设置了与Cookie相关的值。 |
public String getValue() |
这个方法得到了与Cookie相关的值。 |
public void setPath(String uri) |
该方法设置了Cookie应用的路径。如果不指定路径,那么与当前页面相同的目录以及子目录中的所有URL都会返回Cookie。 |
public String getPath() |
该方法获取Cookie应用的路径。 |
public void setSecure(boolean flag) |
此方法设置布尔值,该值表明Cookie是否只能通过加密连接发送(例如SSL)。 |
public void setComment(String purpose) |
这种方法指定了描述Cookie目的的评论。如果浏览器向用户展示了这个Cookie,那么评论是有用的。 |
public String getComment() |
该方法返回描述Cookie目的的评论,如果Cookie没有评论,那么返回null。 |
三、用JSP设置Cookies
用JSP设置Cookies包括三个步骤:
(1) 创建一个Cookie对象: 用Cookie的名称和值调用Cookie构造函数,名称和值是字符串。
Cookie cookie = new Cookie("key","value");
记住,这个名字和值都不应该包含空格或任何以下字符:
[ ] ( ) = , " / ? @ : ;
(2) 设置最大持续时间: 使用setMaxAge指定Cookie的有效期是多长时间(以秒为单位)。以下是建立了一个持续24小时的Cookie。
cookie.setMaxAge(60*60*24);
(3) 将Cookie发送到HTTP响应标题中:使用response.addCookie在HTTP响应标题中添加Cookies,如下所示:
response.addCookie(cookie);
示例:
<% // Create cookies for first and last names. Cookie firstName = new Cookie("first_name", request.getParameter("first_name")); Cookie lastName = new Cookie("last_name", request.getParameter("last_name")); // Set expiry date after 24 Hrs for both the cookies. firstName.setMaxAge(60*60*24); lastName.setMaxAge(60*60*24); // Add both the cookies in the response header. response.addCookie( firstName ); response.addCookie( lastName ); %> <html> <head> <title>Setting Cookies</title> </head> <body> <center> <h1>Setting Cookies</h1> </center> <ul> <li><p><b>First Name:</b> <%= request.getParameter("first_name")%> </p></li> <li><p><b>Last Name:</b> <%= request.getParameter("last_name")%> </p></li> </ul> </body> </html>
将上述代码添加到main.jsp文件中,并在下述的HTML页面中使用:
<html> <body> <form action="main.jsp" method="GET"> First Name: <input type="text" name="first_name"> <br /> Last Name: <input type="text" name="last_name" /> <input type="submit" value="Submit" /> </form> </body> </html>
将上述HTML内容保存在hello.jsp文件中。当访问http://localhost:8080/hello.jsp时,这是表单上的实际输出。
尝试输入姓名,然后单击Submit按钮。这将在屏幕上显示姓名,同时会设置firstName和lastName这两个Cookie,当下次点击Submit按钮时,将传回服务器。
四、用JSP读取Cookies
想要读取Cookie,需要通过调用HttpServletRequest的getCookies()方法创建一个javax.servlet.http数组。然后通过数组循环,使用getName()和getValue()方法来访问每个cookie和相关的值。
示例:
<html> <head> <title>Reading Cookies</title> </head> <body> <center> <h1>Reading Cookies</h1> </center> <% Cookie cookie = null; Cookie[] cookies = null; // Get an array of Cookies associated with this domain cookies = request.getCookies(); if( cookies != null ){ out.println("<h2> Found Cookies Name and Value</h2>"); for (int i = 0; i < cookies.length; i++){ cookie = cookies[i]; out.print("Name : " + cookie.getName( ) + ", "); out.print("Value: " + cookie.getValue( )+" <br/>"); } }else{ out.println("<h2>No cookies founds</h2>"); } %> </body> </html>
现在将上面的代码放在main.jsp文件中并试图访问它。如果之前设置first_name cookie为“John”,last_name cookie 为“Player”,然后运行http:// localhost:8080/main.jsp
,将显示下面的结果:
五、用JSP删除Cookies
删除Cookies非常简单。如果想删除一个Cookie,那么只需要按照以下三步来处理:
-
读取一个已经存在的Cookie并把它保存在Cookie对象中。
-
使用setMaxAge()方法将Cookie的持续时间设置为0来删除一个已经存在的Cookie。
- 将这个Cookie添加到响应标题中。
示例:
以下的例子中删除了现存的命名为“first_name”的Cookie,当下次运行main.jsp,JSP时,first_name会返回空值。
<html> <head> <title>Reading Cookies</title> </head> <body> <center> <h1>Reading Cookies</h1> </center> <% Cookie cookie = null; Cookie[] cookies = null; // Get an array of Cookies associated with this domain cookies = request.getCookies(); if( cookies != null ){ out.println("<h2> Found Cookies Name and Value</h2>"); for (int i = 0; i < cookies.length; i++){ cookie = cookies[i]; if((cookie.getName( )).compareTo("first_name") == 0 ){ cookie.setMaxAge(0); response.addCookie(cookie); out.print("Deleted cookie: " + cookie.getName( ) + "<br/>"); } out.print("Name : " + cookie.getName( ) + ", "); out.print("Value: " + cookie.getValue( )+" <br/>"); } }else{ out.println( "<h2>No cookies founds</h2>"); } %> </body> </html>
现在将上述代码添加到main.jsp中并尝试访问它。它会出现如下所示的结果:
现在尝试再次运行http://localhost:8080/main.jsp
,只会出现如下所示的一个Cookie:
测试工程:https://github.com/easonjim/5_java_example/tree/master/jspbasics/test9