JSP Обработка cookie

Cookie — это текстовые файлы, хранящиеся на клиентской машине, и они хранят много информации для отслеживания. Основываясь на технологии Servlet, JSP, очевидно, может обеспечивать поддержку HTTP-cookie.

Обычно существует три шага для идентификации возвращающихся посетителей:

  • Серверный скрипт отправляет браузеру набор cookie. Например, имя, возраст, номер ID и т. д.
  • Браузер сохраняет эту информацию на локальной машине для дальнейшего использования.
  • В следующий раз, когда браузер отправляет любой запрос на сервер, он также отправит эту информацию cookie на сервер, а затем сервер использует эту информацию для идентификации пользователя или выполнения других действий.

В этой главе вы узнаете, как устанавливать или сбрасывать cookie, а также как получать доступ к ним и удалять их.

Обработка cookie в JSP требует кодирования и декодирования китайских символов следующим образом:

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=example; expires=Friday, 04-Feb-17 22:03:38 GMT; 
                 path=/; domain=example.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-скрипты получают доступ к этим cookie через метод getCookies() объекта request, который возвращает массив объектов Cookie.


Методы Cookie в сервлете

В следующей таблице перечислены часто используемые методы объекта Cookie:

Нет. Метод & Описание
1 public void setDomain(String pattern)

Задаёт домен cookie, например example.com 2 public String getDomain()

Получает домен cookie, например example.com 3 public void setMaxAge(int expiry)Задает срок действия cookie в секундах; срок действия по умолчанию — время жизни текущего сеанса 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, если его нет

Setting Cookies with JSP

Установка cookie с помощью JSP включает три шага:

(1) Создайте объект Cookie:Вызовите конструктор Cookie, используя имя и значение cookie в качестве параметров; оба являются строками.

Cookie cookie = new Cookie("key","value");

Обязательно помните, что ни имя, ни значение не могут содержать пробелы или следующие символы:

[ ] ( ) = , " / ? @ : ;

(2) Установите срок действия:Вызовите функцию setMaxAge(), чтобы указать, как долго (в секундах) cookie остается действительным. Следующая операция устанавливает срок действия в 24 часа.

cookie.setMaxAge(60*60*24); 

(3) Отправьте cookie в заголовок HTTP-ответа:Вызовите функцию response.addCookie(), чтобы добавить cookie в заголовок HTTP-ответа.

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-форма, которая отправляет данные клиента в файл main.jsp методом GET и устанавливает cookie:

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Example(example.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.

Поместите этот файл в каталог WebContent текущего JSP-проекта (тот же каталог, что и main.jsp).

Отправьте данные формы в файл main.jsp, посетив http://localhost:8080/testjsp/test.html. Демонстрационный GIF показан ниже:

Попробуйте ввести "Site Name" и "URL", затем нажмите кнопку отправки. На экране отобразятся "Site Name" и "URL", и будут установлены два cookie, "Site Name" и "URL".


Чтение cookie с помощью JSP

Чтобы прочитать cookie, нужно вызвать метод request.getCookies(), чтобы получить массив объектов javax.servlet.http.Cookie, затем перебрать массив и использовать методы getName() и getValue() для получения имени и значения каждого 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 равным 0.
  • Повторно добавьте этот файл cookie в заголовок ответа.

Пример демонстрации

Следующая программа удаляет cookie с именем "name". Когда вы запустите 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, и вы получите следующий результат:

Вы увидите, что cookie с именем "name" исчез.

Вы также можете вручную удалить куки в браузере. В IE щёлкните пункт меню Сервис, затем выберите Свойства обозревателя и щёлкните Удалить файлы cookie, чтобы удалить все куки.

Другие расширения