Java Web如何操作Cookie的添加修改和删除

一、Cookie是什么

Cookie是服务器存放在客户端浏览器上的一些小数据，可以使用Cookie完成与服务器的一些交互动作。服务器可以通过HTTP响应头将Cookie发送给浏览器，而浏览器如果支持存储Cookie，则将HTTP响应头信息中的Cookie内容存放到浏览器中。当浏览器请求访问一个网站时，如果这个网站在此浏览器中存放有Cookie内容，浏览器会将Cookie内容附加到HTTP请求头信息中发送给服务器。鉴于此，Cookie存放的内容是不宜过多的，一般浏览器也是这样规定的。

浏览器应该支持每台 Web 服务器有 20 个 cookie，总共有 300 个 cookie，并且可能将每个 cookie 的大小限定为 4 KB。

二、Servlet如何创建Cookie对象

Java Web提供了一个Cookie类：javax.servlet.http.Cookie

创建Cookie对象

Cookie是一个类似于键值对的数据，通过Cookie的构造方法Cookie(String name, String value)创建一个Cookie对象，不过Cookie与键值对数据不同的一点儿是，存储在浏览器中的Cookie对象可以拥有相同的name值，这点儿在后面获取Cookie对象的时候需要特别注意。

修改Cookie值

创建好Cookie对象后，我们可以通过setValue(String newValue)方法修改值，通过getValue()获取值。

添加Cookie描述

为了方便客户端用户查看Cookie信息，可以通过setComment(String purpose)方法设置一个描述信息，Cookie还没有发送前，通过getComment()方法获取描述信息。

设置Cookie有效期和删除Cookie

存放在客户端的Cookie是有有效期的，可以通过setMaxAge(int expiry)方法设置这个Cookie可以保存好长时间，单位为秒，这是一个时间长度，不是一个时间点Timestamp。如果没有设置有效期，则默认为-1（或者说小于0的值），表示在浏览器关闭时就删除Cookie内容，如果有效期设置为0，则表示通知浏览器立即删除这个Cookie。

设置Cookie作用范围和域

我们还可以指定Cookie在哪个网页才有效，通过setPath(String uri)方法即可设置，如果值为“／”表示作用范围为整个网站，默认是这个值。

另外还可以指定这个Cooke对其他网站有效（也就是不同的域），通过setDomain(String pattern)方法来实现，不过需要注意的是，一般浏览器是不允许一个网站设置另外网站的Cookie内容的，所以这个用处不大。实在要做，就需要修改浏览器的配置才行。

Cookie中文问题

Cookie有一点儿不好的就是不支持中文，这点儿一定要注意了，如果忘Cookie中添加了中文内容，则系统会抛出异常内容：

java.lang.IllegalArgumentException: Control character in cookie value, consider BASE64 encoding your value

如果确实需要写入中文，则需要进行BASE64转码才行。在读取Cookie的时候又需要进行反转码。

三、如何向客户端写入Cookie

前面说了，Cookie写入浏览器是通过HTTP响应头带入的。在Java Web开发中Response对象已经帮我们完成了这个工作，通过Response的addCookie(Cookie cookie)方法就可以向浏览器写入Cookie内容了。一个响应头可以带入多个Cookie，所以这个方法也可以多次调用，一次写入多个Cookie。

四、获取客户端发送来的Cookie

跟向浏览器写入Cookie相反，客户端通过HTTP请求头将Cookie带入发送给服务器。通过Request.getCookies()方法可以获取到从客户端发送来的Cookie数组。不过从浏览器发送过来的Cookie对象只有name属性和value属性，其他有效期，有效路径等都是没有的。而且可以有多个相同的name属性的，所以判断是不是我们需要的Cookie需要审慎的。

五、实现代码

添加Cookie：

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

        // 1.创建Cookie对象

        Cookie cookie1 = new Cookie("webname", "XCoder Studio");

        // 2.配置Cookie对象

        cookie1.setComment("Web Host Name");    // Cookie描述

        cookie1.setMaxAge(24*60*60);            // Cookie有效时间

        //cookie1.setPath("/");                 // Cookie有效路径


        // 3.通过response对象将Cookie写入浏览器，当然需要解决中文乱码问题，否则会抛出异常

        // java.lang.IllegalArgumentException: Control character in cookie value, consider BASE64 encoding your value

        response.setCharacterEncoding("UTF-8");

        response.setContentType("text/html;charset=UTF-8");

        response.addCookie(cookie1);


        // 跳转到首页

        response.sendRedirect("./index.jsp");

    }

 

读取Cookie：​​​​​​​

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

    // 读取Cookie，通过request请求读取Cookie

    Cookie[] cookies = request.getCookies();


    // 判断是否存在Cookie，不存在跳转到首页

    if (cookies == null) {

        response.sendRedirect("./index.jsp");

        return;

    }


    // 处理输出中文乱码问题

    response.setCharacterEncoding("UTF-8");

    response.setContentType("text/html;charset=UTF-8");

    // 获取输出对象

    PrintWriter out = response.getWriter();

    // 迭代处理客户端发送来的Cookie对象


    for (Cookie cookie:cookies) {

        out.println("Cookie名   称："+cookie.getName()+"<br />");

        out.println("Cookie储   值："+cookie.getValue()+"<br />");

        out.println("Cookie备   注："+cookie.getComment()+"<br />");

        out.println("Cookie有效时间："+cookie.getMaxAge()+"<br />");

        out.println("Cookie有效路径："+cookie.getPath()+"<br />");

        out.println("Cookie有效域名："+cookie.getDomain()+"<br />");

        out.println("<a href=\"./CookieDel?name="+cookie.getName()+"\">删除Cookie</a><br />");

        out.println("---------------------------------------------------------<br />");

    }

}

 

删除Cookie：

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

    // 获取GET传递参数名称

    String delName = request.getParameter("name");

    if (delName == null) {

        response.sendRedirect("./CookieRead");

        return;

    }


    // 获取Cookies数组

    Cookie[] cookies = request.getCookies();

    // 迭代查找并清除Cookie

    for (Cookie cookie: cookies) {

        if (delName.equals(cookie.getName())) {

            cookie.setMaxAge(0);

            response.addCookie(cookie);

        }

    }


    response.setHeader("refresh", "3;./CookieRead");

    PrintWriter out = response.getWriter();

    out.println("Will go back after 3 seconds...");

}

运行会发现读取Cookie时，所以的有效时间都是Null的。