【Java基础知识】Servlet学习之Servlet API - javax.servlet软件包（三）

4、Cookie类

public class Cookie implements Cloneable

储存在用户本地客户端上的数据，可以由用户客户端计算机暂时或永久保存的数据信息。

(1)构造函数

public Cookie(String name, String value)

用一个“key-value键值对”定义一个Cookie对象。

(2)Cookie相关方法

public void setComment(String purpose)

设置Cookie注释，用来描述Cookie对象的作用。

public String getComment()

获取Cookie对象的注释，如果没有设置注释，则返回空值null。

public String getName()

获取Cookie对象中存储的key。

public void setValue(String newValue)

设置Cookie对象中的value值，以覆盖旧值。

public String getValue()

获取Cookie对象中存储的value值。

public void setDomain(String pattern)

设置Cookie对象的有效域。这个属性指定Cookie对象可以出现的区域。

例如：一个有效域以一个点开头(.foo.com)，则意味着在指定的域名解析系统的区域中(可能是www.foo.com，而不是a.b.foo.com)的主机可以使用该Cookie对象。默认情况是，Cookie只能被保存它的客户机使用。

public String getDomain()

获取Cookie对象可以使用的区域，如果未定义，则返回空值null。

public void setMaxAge(int expiry)

设置Cookie对象在客户机上保存的最长时间，单位：秒。在该生命期之后，Cookie对象会被销毁。

参数expiry可以是正整数、负整数、0。

若expiry为0，则表示从客户机上立即删除这个Cookie对象;若expiry为正整数，则表示将Cookie对象保存在客户机上的最长时间为指定的秒数;若expiry为负整数，则将Cookie对象保存在客户端浏览器内存中，当浏览器关闭时，Cookie对象就会被删除。

默认情况下，Cookie对象的Max-Age属性值为-1。

public int getMaxAge()

获取Cookie对象的最大生命周期。如果未设置，则返回-1。

public void setPath(String uri)

设置Cookie对象的访问路径，只有以给定String开头的路径，才能使用该Cookie对象。

public String getPath()

获取允许使用Cookie对象的所有有效URL路径，如果没有设置，则返回空值null。

public void setSecure(boolean flag)

设置Cookie对象是否通过安全通道(例如：HTTPS、SSL)传输，默认为:false。

public boolean getSecure()

如果Cookie对象通过安全通道传输，则返回true，否则,返回false。

public void setVersion(int v)

设置 Cookie版本号。

public int getVersion()

获取Cookie版本号。