JavaTM 2 Platform
Standard Ed. 6

java.net
接口 CookieStore


public interface CookieStore

表示 cookie 存储区的 CookieStore 对象。可以存储和获取 cookie。

CookieManager 将调用 CookieStore.add 为每个传入的 HTTP 响应保存 cookie,调用 CookieStore.get 为每个传出的 HTTP 请求获取 cookie。CookieStore 负责移除已过期的 HttpCookie 实例。

从以下版本开始:
1.6

方法摘要
 void add(URI uri, HttpCookie cookie)
          将一个 HTTP cookie 添加到存储区中。
 List<HttpCookie> get(URI uri)
          获取与给定 URI 关联或其域与给定 URI 匹配的 cookie。
 List<HttpCookie> getCookies()
          获取 cookie 存储区中所有未过期的 cookie。
 List<URI> getURIs()
          获取所有标识此 cookie 存储区中 cookie 的 URI。
 boolean remove(URI uri, HttpCookie cookie)
          从存储区中移除 cookie。
 boolean removeAll()
          移除此 cookie 存储区中的所有 cookie。
 

方法详细信息

add

void add(URI uri,
         HttpCookie cookie)
将一个 HTTP cookie 添加到存储区中。为每个传入的 HTTP 响应调用此方法。

要存储的 cookie 可能关联 URI,也可能不关联 URI。如果它不关联 URI,那么 cookie 的域和路径属性将指示其出处。如果它关联 URI,则不指定它的域和路径属性,给定 URI 将指示此 cookie 的出处。

如果对应于给定 URI 的 cookie 已经存在,则使用新的 cookie 替换它。

参数:
uri - 此 cookie 关联的 uri。如果为 null,则此 cookie 不关联 URI
cookie - 要存储的 cookie
抛出:
NullPointerException - 如果 cookienull
另请参见:
get(java.net.URI)

get

List<HttpCookie> get(URI uri)
获取与给定 URI 关联或其域与给定 URI 匹配的 cookie。只返回未过期的 cookie。为每个传出的 HTTP 请求调用此方法。

返回:
HttpCookie 的不可变列表;如果没有与给定 URI 匹配的 cookie,则返回空列表
抛出:
NullPointerException - 如果 urinull
另请参见:
add(java.net.URI, java.net.HttpCookie)

getCookies

List<HttpCookie> getCookies()
获取 cookie 存储区中所有未过期的 cookie。

返回:
http cookie 的不可变列表;如果存储区中没有 http cookie,则返回空列表

getURIs

List<URI> getURIs()
获取所有标识此 cookie 存储区中 cookie 的 URI。

返回:
URI 的不可变列表;如果此 cookie 存储区中的 cookie 都不关联 URI,则返回空列表

remove

boolean remove(URI uri,
               HttpCookie cookie)
从存储区中移除 cookie。

参数:
uri - 此 cookie 关联的 uri。如果为 null,则添加时要移除的 cookie 不关联 URI;如果不为 null,则添加时要移除的 cookie 与给定的 URI 关联。
cookie - 要移除的 cookie
返回:
如果此存储区包含指定的 cookie,则返回 true
抛出:
NullPointerException - 如果 cookienull

removeAll

boolean removeAll()
移除此 cookie 存储区中的所有 cookie。

返回:
如果此存储区由于调用而更改,则返回 true

JavaTM 2 Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策