Java Servlet和JSP 处理Cookie

9.1 Cookie概述

　　 Cookie是服务器发送给浏览器的体积很小的纯文本信息，用户以后访问同一个Web服务器时浏览器会把它们原样发送给服务器。通过让服务器读取它原先保存到客户端的信息，网站能够为浏览者提供一系列的方便，例如在线交易过程中标识用户身份、安全要求不高的场合避免用户重复输入名字和密码、门户网站的主页定制、有针对性地投放广告，等等。

　　 Cookie的目的就是为用户带来方便，为网站带来增值。虽然有着许多误传，事实上Cookie并不会造成严重的安全威胁。Cookie永远不会以任何方式执行，因此也不会带来病毒或攻击你的系统。另外，由于浏览器一般只允许存放300个Cookie，每个站点最多存放20个Cookie，每个Cookie的大小限制为4 KB，因此Cookie不会塞满你的硬盘，更不会被用作“拒绝服务”攻击手段。

　　 9.2 Servlet的Cookie API

　　 要把Cookie发送到客户端，Servlet先要调用new Cookie(name,value)用合适的名字和值创建一个或多个Cookie（2.1节），通过cookie.setXXX设置各种属性（2.2节），通过response.addCookie(cookie)把cookie加入应答头（2.3节）。

　　 要从客户端读入Cookie，Servlet应该调用request.getCookies()，getCookies()方法返回一个Cookie对象的数组。在大多数情况下，你只需要用循环访问该数组的各个元素寻找指定名字的Cookie，然后对该Cookie调用getValue方法取得与指定名字关联的值，这部分内容将在2.4节讨论。

　　 9.2.1 创建Cookie

　　 调用Cookie对象的构造函数可以创建Cookie。Cookie对象的构造函数有两个字符串参数：Cookie名字和Cookie值。名字和值都不能包含空白字符以及下列字符：
  [ ] ( ) = , " / ? @ : ;




　　 9.2.2 读取和设置Cookie属性

　　 把Cookie加入待发送的应答头之前，你可以查看或设置Cookie的各种属性。下面摘要介绍这些方法：

getComment/setComment
获取/设置Cookie的注释。
getDomain/setDomain
获取/设置Cookie适用的域。一般地，Cookie只返回给与发送它的服务器名字完全相同的服务器。使用这里的方法可以指示浏览器把Cookie返回给同一域内的其他服务器。注意域必须以点开始（例如.sitename.com），非国家类的域（如.com，.edu，.gov）必须包含两个点，国家类的域（如.com.cn，.edu.uk）必须包含三个点。
getMaxAge/setMaxAge
获取/设置Cookie过期之前的时间，以秒计。如果不设置该值，则Cookie只在当前会话内有效，即在用户关闭浏览器之前有效，而且这些Cookie不会保存到磁盘上。参见下面有关LongLivedCookie的说明。
getName/setName
获取/设置Cookie的名字。本质上，名字和值是我们始终关心的两个部分。由于HttpServletRequest的getCookies方法返回的是一个Cookie对象的数组，因此通常要用循环来访问这个数组查找特定名字，然后用getValue检查它的值。
getPath/setPath
获取/设置Cookie适用的路径。如果不指定路径，Cookie将返回给当前页面所在目录及其子目录下的所有页面。这里的方法可以用来设定一些更一般的条件。例如，someCookie.setPath("/")，此时服务器上的所有页面都可以接收到该Cookie。
getSecure/setSecure
获取/设置一个boolean值，该值表示是否Cookie只能通过加密的连接（即SSL）发送。
getValue/setValue
获取/设置Cookie的值。如前所述，名字和值实际上是我们始终关心的两个方面。不过也有一些例外情况，比如把名字作为逻辑标记（也就是说，如果名字存在，则表示true）。
getVersion/setVersion
获取/设置Cookie所遵从的协议版本。默认版本0（遵从原先的Netscape规范）；版本1遵从RFC 2109 ， 但尚未得到广泛的支持。
　　 9.2.3 在应答头中设置Cookie

　　 Cookie可以通过HttpServletResponse的addCookie方法加入到Set-Cookie应答头。下面是一个例子：
  Cookie userCookie = new Cookie("user", "uid1234");
  response.addCookie(userCookie);




　　 9.2.4 读取保存到客户端的Cookie

　　 要把Cookie发送到客户端，先要创建Cookie，然后用addCookie发送一个Set-Cookie HTTP应答头。这些内容已经在上面的2.1节介绍。从客户端读取Cookie时调用的是HttpServletRequest的getCookies方法。该方法返回一个与HTTP请求头中的内容对应的Cookie对象数组。得到这个数组之后，一般是用循环访问其中的各个元素，调用getName检查各个Cookie的名字，直至找到目标Cookie。然后对这个目标Cookie调用getValue，根据获得的结果进行其他处理。

　　 上述处理过程经常会遇到，为方便计下面我们提供一个getCookieValue方法。只要给出Cookie对象数组、Cookie名字和默认值，getCookieValue方法就会返回匹配指定名字的Cookie值，如果找不到指定Cookie，则返回默认值。

　　 9.3 几个Cookie工具函数

　　 下面是几个工具函数。这些函数虽然简单，但是，在和Cookie打交道的时候很有用。

　　 9.3.1 获取指定名字的Cookie值

　　 该函数是ServletUtilities.java的一部分。getCookieValue通过循环依次访问Cookie对象数组的各个元素，寻找是否有指定名字的Cookie，如找到，则返回该Cookie的值；否则，返回参数中给出的默认值。getCookieValue能够在一定程度上简化Cookie值的提取。
  public static String getCookieValue(Cookie[] cookies,
               String cookieName,
               String defaultValue) {
    for(int i=0; i＜cookies.length; i++) {
      Cookie cookie = cookies[i];
      if (cookieName.equals(cookie.getName()))
        return(cookie.getValue());
    }
    return(defaultValue);
  }




　　 9.3.2自动保存的Cookie

　　 下面是LongLivedCookie类的代码。如果你希望Cookie能够在浏览器退出的时候自动保存下来，则可以用这个LongLivedCookie类来取代标准的Cookie类。
package hall;

import javax.servlet.http.*;

public class LongLivedCookie extends Cookie {
  public static final int SECONDS_PER_YEAR = 60*60*24*365;
  public LongLivedCookie(String name, String value) {
    super(name, value);
    setMaxAge(SECONDS_PER_YEAR);
  }
}




　　 9.4.实例：定制的搜索引擎界面

　　 下面也是一个搜索引擎界面的例子，通过修改前面HTTP状态代码的例子得到。在这个Servlet中，用户界面是动态生成而不是由静态HTML文件提供的。Servlet除了负责读取表单数据并把它们发送给搜索引擎之外，还要把包含表单数据的Cookie发送给客户端。以后客户再次访问同一表单时，这些Cookie的值将用来预先填充表单，使表单自动显示最近使用过的数据。

　　 SearchEnginesFrontEnd.java

　　 该Servlet构造一个主要由表单构成的用户界面。第一次显示的时候，它和前面用静态HTML页面提供的界面差不多。然而，用户选择的值将被保存到Cookie（本页面将数据发送到CustomizedSearchEngines Servlet，由后者设置Cookie）。用户以后再访问同一页面时，即使浏览器是退出之后再启动，表单中也会自动填好上一次搜索所填写的内容。

　　 注意该Servlet用到了ServletUtilities.java，其中getCookieValue前面已经介绍过，headWithTitle用于生成HTML页面的一部分。另外，这里也用到了前面已经说明的LongLiveCookie类，我们用它来创建作废期限很长的Cookie。
package hall;

import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.net.*;

public class SearchEnginesFrontEnd extends HttpServlet {
  public void doGet(HttpServletRequest request,
                 HttpServletResponse response)
      throws ServletException, IOException {
    Cookie[] cookies = request.getCookies();
    String searchString =
      ServletUtilities.getCookieValue(cookies,
             "searchString",
             "Java Programming");
    String numResults =
      ServletUtilities.getCookieValue(cookies,
             "numResults",
             "10");
    String searchEngine =
      ServletUtilities.getCookieValue(cookies,
              "searchEngine",
              "google");
    response.setContentType("text/html");
    PrintWriter out = response.getWriter();
    String title = "Searching the Web";
    out.println(ServletUtilities.headWithTitle(title) +
                "＜BODY BGCOLOR=＼"#FDF5E6＼"＞＼n" +
                "＜H1 ALIGN=＼"CENTER＼"＞Searching the Web＜/H1＞＼n" +
                "＼n" +
                "＜FORM ACTION=＼"/servlet/hall.CustomizedSearchEngines＼"＞＼n" +
                "＜CENTER＞＼n" +
                "Search String:＼n" +
                "＜INPUT TYPE=＼"TEXT＼" NAME=＼"searchString＼"＼n" +
                "       VALUE=＼"" + searchString + "＼"＞＜BR＞＼n" +
                "Results to Show Per Page:＼n" +
                "＜INPUT TYPE=＼"TEXT＼" NAME=＼"numResults＼"＼n" +
                "       VALUE=" + numResults + " SIZE=3＞＜BR＞＼n" +
                "＜INPUT TYPE=＼"RADIO＼" NAME=＼"searchEngine＼"＼n" +
                "       VALUE=＼"google＼"" +
                checked("google", searchEngine) + "＞＼n" +
                "Google |＼n" +
                "＜INPUT TYPE=＼"RADIO＼" NAME=＼"searchEngine＼"＼n" +
                "       VALUE=＼"infoseek＼"" +
                checked("infoseek", searchEngine) + "＞＼n" +
                "Infoseek |＼n" +
                "＜INPUT TYPE=＼"RADIO＼" NAME=＼"searchEngine＼"＼n" +
                "       VALUE=＼"lycos＼"" +
                checked("lycos", searchEngine) + "＞＼n" +
                "Lycos |＼n" +
                "＜INPUT TYPE=＼"RADIO＼" NAME=＼"searchEngine＼"＼n" +
                "       VALUE=＼"hotbot＼"" +
                checked("hotbot", searchEngine) + "＞＼n" +
                "HotBot＼n" +
                "＜BR＞＼n" +
                "＜INPUT TYPE=＼"SUBMIT＼" VALUE=＼"Search＼"＞＼n" +
                "＜/CENTER＞＼n" +
                "＜/FORM＞＼n" +
                "＼n" +
                "＜/BODY＞＼n" +
                "＜/HTML＞＼n");
  }

  private String checked(String name1, String name2) {
    if (name1.equals(name2))
      return(" CHECKED");
    else
      return("");
  }
}




　　 CustomizedSearchEngines.java

　　 前面的SearchEnginesFrontEnd Servlet把数据发送到CustomizedSearchEngines Servlet。本例在许多方面与前面介绍HTTP状态代码时的例子相似，区别在于，本例除了要构造一个针对搜索引擎的URL并向用户发送一个重定向应答之外，还要发送保存用户数据的Cookies。
package hall;

import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.net.*;

public class CustomizedSearchEngines extends HttpServlet {
  public void doGet(HttpServletRequest request,
                    HttpServletResponse response)
      throws ServletException, IOException {
  
    String searchString = request.getParameter("searchString");
    Cookie searchStringCookie =
      new LongLivedCookie("searchString", searchString);
    response.addCookie(searchStringCookie);
    searchString = URLEncoder.encode(searchString);
    String numResults = request.getParameter("numResults");
    Cookie numResultsCookie =
      new LongLivedCookie("numResults", numResults);
    response.addCookie(numResultsCookie);
    String searchEngine = request.getParameter("searchEngine");
    Cookie searchEngineCookie =
      new LongLivedCookie("searchEngine", searchEngine);
    response.addCookie(searchEngineCookie);
    SearchSpec[] commonSpecs = SearchSpec.getCommonSpecs();
    for(int i=0; i＜commonSpecs.length; i++) {
      SearchSpec searchSpec = commonSpecs[i];
      if (searchSpec.getName().equals(searchEngine)) {
        String url =
          searchSpec.makeURL(searchString, numResults);
        response.sendRedirect(url);
        return;
      }
    }
    response.sendError(response.SC_NOT_FOUND,
                       "No recognized search engine specified.");
  }

  public void doPost(HttpServletRequest request,
                     HttpServletResponse response)
      throws ServletException, IOException {
    doGet(request, response);
  }
}



===========================

几个实用的Servlet应用例子-入门、cookie、session及上传文件



　　Servlet可以被认为是服务端的applet，它被WEB服务器加载和执行，前端可以显示页面和获得页面数据，后台可以操纵数据库，能完成JavaBean的很多功能。在这里我较为详细的说说Servlet在Cookie，Session和上传文件上的应用，在说明时我给出一些能编绎运行的小例子，最后给出一个文件上传例子以加深印象。
　　我们先来看看SERVLET程序的基本构架：
式1：
　　package test;
　　import javax.servlet.*;
　　import javax.servlet.http.*;
　　import java.io.*;
　　import java.util.*;
　　public class test extends HttpServlet {
　　public void init(ServletConfig config) throws ServletException {
　　super.init(config);
}
　　public void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
　　int f =1; switch(f){
　　case 1:firstMothed(request,respponse);break;
}
}
　　public void firstMothed(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
　　response.setContentType("text/html");
　　OutputStreamWriter osw = new
　　OutputStreamWriter(response.getOutputStream());
　　PrintWriter out = new PrintWriter (response.getOutputStream());
　　out.println("< html>");
　　out.println("< head>< title>Servlet1< /title>< /head>");
　　out.println("< body>你好！");
　　out.println("< /body>< /html>");
　　out.close();
}
}
式2：
　　package test;
　　import javax.servlet.*;
　　import javax.servlet.http.*;
　　import java.io.*;
　　import java.util.*;
　　public class test extends HttpServlet {
　　public void init(ServletConfig config) throws ServletException {
　　super.init(config);
}
　　public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
　　response.setContentType("text/html");
　　OutputStreamWriter osw = new OutputStreamWriter(response.getOutputStream());
　　PrintWriter out = new PrintWriter (response.getOutputStream());
　　out.println("< html>");
　　out.println("< head>< title>Servlet1< /title>< /head>");
　　out.println("< body>你好！");
　　out.println("< /body>< /html>");
　　out.close();
}
　　public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
　　response.setContentType("text/html");
　　OutputStreamWriter osw = new OutputStreamWriter(response.getOutputStream());
　　PrintWriter out = new PrintWriter (response.getOutputStream());
　　out.println("< html>");
　　out.println("< head>< title>Servlet1< /title>< /head>");
　　out.println("< body>你好！");
　　out.println("< /body>< /html>");
　　out.close();
}
}
　　式1适合于作总控模块，此SERVLET作中间调度，根据不同的f值调用不同的SERVLET或方法。
式2适合于对html的get和post有不同要求的情况。
　　但这并不是绝对的，式2就完全可以代替式1，只要在doGet()方法中写上doPost就与式1完全一样。
在init方法中执行的语句，只要这个servlet被启动了就一直有效，比如，我们在init()中new了一个对象，那么这个对象的内存空间就永远存在，除非显式地把这个对象赋为null，或重启服务。
　　HttpServletRequest和HttpServletResponse两个对象实现http请求，它们有很多有用的方法，在下面的cookie和session管理中会细加描述。
　　1， cookie管理 cookie用于在客户端保存个人所特有的信息，它采取在客户机写临时文件的机制。
　　package test;
　　import javax.servlet.*;
　　import javax.servlet.http.*;
　　import java.io.*;
　　import java.util.*;
　　public class test extends HttpServlet {
　　public void init(ServletConfig config) throws ServletException {
　　super.init(config);
}
　　public void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
　　//写cookie
　　String CookieName ="js79"; //若是汉字则需编码
　　String CookieValue = "yesky";//若是汉字则需编码
　　Cookie cookie = new Cookie(CookieName,CookieValue);
　　cookie.setMaxAge(age); // age = Integer.MAX_VALUE 永不过期
　　cookie.setPath("/");
　　//读cookie
　　String value = null;
　　Cookie[] cookies = request.getCookies();
　　if (cookies != null) {
　　for (int i=0; i< cookies.length; i++) {
　　if (cookies[i].getName().equals(CookieName))
　　value = cookies[i].getValue();
　　break;
}
}
}
　　response.setContentType("text/html");
　　OutputStreamWriter osw = new OutputStreamWriter(response.getOutputStream());
　　PrintWriter out = new PrintWriter (response.getOutputStream());
　　out.println("< html>");
　　out.println("< head>< title>test< /title>< /head>");
　　out.println("cookie键:"+CookieName+"< br>");
　　out.println("cookie值: "+value);
　　out.println("< /body>< /html>");
　　out.close();
}
}
　　2,session管理
　　Session在Servlet中是很有用的，它比cookie安全可靠灵活，但是管理起来有点麻烦，用得不好会造成服务器的开销很大，浪费资源。下面是一个基于Session管理一个对象的简单例子。
一个简单的bean对象TestObject
　　package test;
　　public class TestObject extends Object {
　　int id = 0; public String cur="";
}
　　package test;
　　import javax.servlet.*;
　　import javax.servlet.http.*;
　　import java.io.*;
　　import java.util.*;
　　public class TestMan extends HttpServlet {
　　public void init(ServletConfig config) throws ServletException {
　　super.init(config);
}
　　public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
　　int f = 1;
　　if(request.getParameter("f")!=null)
　　f =
　　Integer.parseInt(request.getParameter("f"));
　　switch(f){
　　case 1: this.getResult(request,response);
　　break;
　　case 2:
　　this.setSession(request,response);
　　break;
}
}
　　public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
　　doGet(request,response);
}
　　public void getResult(HttpServletRequest request, HttpServletResponse response) 　　throws ServletException, IOException {
　　TestObject testObject = null;
　　testObject = getStatus(request,response);
　　String html = testObject.id; doWrite( response,html);
}
　　public void setSession(HttpServletRequest request, HttpServletResponse response) 　throws ServletException, IOException {
　　HttpSession session = request.getSession();
　　TestObject testObject = null;
　　testObject = getStatus(request,response);
　　String tmp = null;
　　tmp = request.getParameter("id");
　　if(tmp != null) testObject.id = tmp;
　　session.putValue("testObject ",article);
　　getResult(request,response);
}
　　private TestObject getStatus(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
　　HttpSession session = request.getSession();
　　TestObject testObject = null;
　　if(session!=null){
　　if(session.getValue("testObject ")!=null){
　　testObject = (TestObject)session.getValue("testObject ");
}
　　else{
　　testObject = new TestObject ();
}
}
　　else{
　　testObject = new TestObject ();
}
　　return testObject;
}
　　private void doWrite(HttpServletResponse response,String html) throws 　　ServletException, IOException {
　　PrintWriter out = response.getWriter();
　　out.println(html);
　　out.close();
}
　　/////////////////////////////////////////////////////////
}
　　若能轻松搞定上面的例子，相信读者对SERVLET已有了较为深刻的理解。
下面再介绍一个上传文件例子，其中汲及到了下载的免费JavaBean (如有感兴趣的朋友，可来函索要免费JavaBean源代码,Email:[e-mail])
　　上传基本原理：由页面发出一个http请求，服务端得到请求后，解析多媒体协议，读出文件内容，写文件内容到服务器，所有的这些功能都封装到JavaBean中。
　　上传文件的必需条件：Browser端< form>表单的ENCTYPE属性值必须为 multipart/form-data，它告诉我们传输的数据要用到多媒体传输协议，由于多媒体传输的都是大量的数据，所以规定上传文件必须是post 方法，< input>的type属性必须是file。
　　package upload;
　　import javax.servlet.*;
　　import javax.servlet.http.*;
　　import java.io.*;
　　import java.util.*;
　　public class UpLoadServlet extends HttpServlet {
　　public void init(ServletConfig config) throws ServletException{
　　super.init(config);
}
　　public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
　　PrintWriter out = response.getWriter();
　　out.println("< HTML>< HEAD>< TITLE>UpLoad< /TITLE>"
　　+"< meta http-equiv=´Content-Type´ content=´text/html; charset=gb2312´>"
　　+"< /HEAD>"
　　+"< body>");
　　out.println("< div align=´center´ valign=´top´>"
　　+"< span class=´nava´>请你选择上传的文件(请注意文件大小只能在20K之内)< /span>< BR>"
　　+"< form ENCTYPE=´multipart/form-data´ method=post action=´´>"
　　+"< input type=´file´ name=´file´>"
　　+"< input type=´submit´ value=´发送´>"
　　+"< /form>"
　　+"< /div>");
　　out.println("< /body>< /html>");
　　out.close();
}
　　////////
　　public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
　　PrintWriter out = response.getWriter();
　　int tmpID = 1; try {
　　MultipartRequest multi = new MultipartRequest(request,"/home/js79/html/", 5 * 1024 * 1024);
}
　　catch(Exception e){
　　tmpID = -1; System.out.println(e);
}
　　if(tmpID == 1){
　　out.println("< HTML>< HEAD>< TITLE>UpLoad< /TITLE>"
　　+"< meta http-equiv=´Content-Type´ content=´text/html; charset=gb2312´>"
　　+"< /HEAD>"
　　+"< body>");
　　out.println("上传成功！< /body>< /html>");
}
　　else{
　　out.println("< HTML>< HEAD>< TITLE>UpLoad< /TITLE>"
　　+"< meta http-equiv=´Content-Type´ content=´text/html; charset=gb2312´>"
　　+"< /HEAD>"
　　+"< body>");
　　out.println("上传不成功！< /body>< /html>");
}
　　out.close();
}
}