CookieStore

public interface CookieStore

CookieStore 对象表示 cookie 的存储。 可以存储和检索cookies。

CookieManager 将调用 CookieStore.add 为每个传入的 HTTP 响应保存 cookie，并调用 CookieStore.get 为每个传出的 HTTP 请求检索 cookie。 CookieStore 负责删除已过期的 HttpCookie 实例。

方法总结

修饰符和类型	方法	描述
void	add(URI uri, HttpCookie cookie)	将一个 HTTP cookie 添加到存储中。
ListHttpCookie	get(URI uri)	检索与给定 URI 关联的 cookie，或者其域与给定 URI 匹配的 cookie。
ListHttpCookie	getCookies()	在 cookie 存储中获取所有未过期的 cookie。
ListURI	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 关联，则 cookie 的域和路径属性将指示它来自何处。 如果它与 URI 相关联并且未指定其域和路径属性，则给定的 URI 将指示此 cookie 的来源。

如果与给定 URI 对应的 cookie 已经存在，则将其替换为新的。

参数：

参数名称	参数描述
uri	与此 cookie 关联的 uri。 如果为 null，则此 cookie 不会与 URI 关联
cookie	要存储的 cookie

Throws:

Throw名称	Throw描述
NullPointerException	如果 cookie 为空

get

ListHttpCookie get(URI uri)

检索与给定 URI 关联的 cookie，或者其域与给定 URI 匹配的 cookie。 仅返回未过期的 cookie。 每个传出的 HTTP 请求都会调用它。

参数：

参数名称	参数描述
uri	与要返回的 cookie 关联的 uri

返回:

一个不可变的 HttpCookie 列表，如果没有 cookie 匹配给定的 URI，则返回空列表

Throws:

Throw名称	Throw描述
NullPointerException	如果 uri 为空

getCookies

ListHttpCookie getCookies()

在 cookie 存储中获取所有未过期的 cookie。

返回:

一个不可变的 http cookie 列表； 如果存储中没有 http cookie，则返回空列表

getURIs

ListURI 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

Throws:

Throw名称	Throw描述
NullPointerException	如果 cookie 为空

removeAll

boolean removeAll()

删除此 cookie 存储中的所有 cookie。

返回:

如果此存储因调用而更改，则为 true