Cookie API
为了封装Cookie信息，在Servlet API中提供了一个javax.servlet.http.Cookie类，该类包含了生成Cookie信息和提取Cookie信息各个属性的方法。Cookie的构造方法和常用方法具体如下：
1、构造方法
Cookie类有且仅有一个构造方法，具体语法格式如下：
public Cookie(java.lang.String name,java.lang.String value)在Cookie的构造方法中，参数name用于指定Cookie的名称，value用于指定Cookie的值。需要注意的是，Cookie一旦创建，它的名称就不能更改，Cookie的值可以为任何值，创建后允许被修改。
2、Cookie类的常用方法
通过Cookie的构造方法创建Cookie对象后，便可调用该类的所有方法，表6-1列举了Cookie的常用方法。
表1 Cookie类的常用方法
| 方法声明 | 功能描述 |
|---|---|
| String getName() | 用于返回Cookie的名称 |
| void setValue(String newValue) | 用于设置Cookie的值 |
| String getValue() | 用于获取Cookie的值 |
| void setMaxAge(int expiry) | 用于设置Cookie在浏览器客户机上保持有效的秒数 |
| int getMaxAge() | 用于获取Cookie在浏览器客户机上保持有效的秒数 |
void [setPath](mk:@MSITStore:C:\Documents and Settings\Administrator\桌面\javaweb课件\Servlet-API.chm::/javax/servlet/http/Cookie.html#setPath(java.lang.String))(String uri) |
用于设置该Cookie项的有效目录路径 |
| String getPath() | 用于返回该Cookie项的有效目录路径 |
void [setDomain](mk:@MSITStore:C:\Documents and Settings\Administrator\桌面\javaweb课件\Servlet-API.chm::/javax/servlet/http/Cookie.html#setDomain(java.lang.String))(String pattern) |
用于设置该Cookie项的有效域 |
| String getDomain() | 用于设置和返回该Cookie项的有效域 |
void [setVersion](mk:@MSITStore:C:\Documents and Settings\Administrator\桌面\javaweb课件\Servlet-API.chm::/javax/servlet/http/Cookie.html#setVersion(int))(int v) |
用于设置该Cookie项采用的协议版本 |
| int getVersion() | 用于返回该Cookie项采用的协议版本 |
void [setComment](mk:@MSITStore:C:\Documents and Settings\Administrator\桌面\javaweb课件\Servlet-API.chm::/javax/servlet/http/Cookie.html#setComment(java.lang.String))(String purpose) |
用于设置该Cookie项的注解部分 |
| String getComment() | 用于返回该Cookie项的注解部分 |
void [setSecure](mk:@MSITStore:C:\Documents and Settings\Administrator\桌面\javaweb课件\Servlet-API.chm::/javax/servlet/http/Cookie.html#setSecure(boolean))(boolean flag) |
用于设置该Cookie项是否只能使用安全的协议传送 |
| boolean getSecure() | 用于返回该Cookie项是否只能使用安全的协议传送 |
表1中列举了Cookie类的常用方法，由于大多数方法都比较简单，接下来，只针对表中比较难以理解的方法进行讲解，具体如下：
●setMaxAge(int expiry)和getMaxAge()方法
上面的这两个方法用于设置和返回Cookie在浏览器上保持有效的秒数。如果设置的值为一个正整数时，浏览器会将Cookie信息保存在本地硬盘中。从当前时间开始，在没有超过指定的秒数之前，这个Cookie都保持有效，并且同一台计算机上运行的该浏览器都可以使用这个Cookie信息；如果设置值为负整数时，浏览器会将Cookie信息保存在的缓存中，当浏览器关闭时，Cookie信息会被删除。如果设置值为0时，则表示通知浏览器立即删除这个Cookie信息。默认情况下，Max-Age属性的值是-1。
● setPath(`String uri)和getPath()方法
上面的这两个方法是针对Cookie的Path属性。如果创建的某个Cookie对象没有设置Path属性，那么该Cookie只对当前访问路径所属的目录及其子目录有效。如果想让某个Cookie项对站点的所有目录下的访问路径都有效，应调用Cookie对象的setPath()方法将其Path属性设置为“/”。
●setDomain(String pattern)和getDomain()方法
上面的这两个方法是针对Cookie的Domain属性的。Domain属性是用来指定浏览器访问的域。例如，传智播客的域为“itcast.cn”。那么，当设置Domain属性时，其值必须以“.”开头，如Domain=.itcast.cn。默认情况下，Domain属性的值为当前主机名，浏览器在访问当前主机下的资源时，都会将Cookie信息回送给服务器。需要注意的是，Domain属性的值是不区分大小写的。
隐藏目录
