public interface CookieStore
| java.net.CookieStore |
CookieStore对象表示cookie的存储。 可以存储和检索cookie。
CookieManager将调用CookieStore.add为每个传入的HTTP响应保存cookie，并调用CookieStore.get为每个传出的HTTP请求检索cookie。 CookieStore负责删除已过期的HttpCookie实例。
Public methods |
|
|---|---|
abstract void |
add(URI uri, HttpCookie cookie) 将一个HTTP cookie添加到商店。 |
abstract List<HttpCookie> |
get(URI uri) 检索与给定URI相关联的Cookie，或者其域名与给定URI相匹配的Cookie。 |
abstract List<HttpCookie> |
getCookies() 在cookie存储中获取所有未过期的Cookie。 |
abstract List<URI> |
getURIs() 获取标识此Cookie存储中cookie的所有URI。 |
abstract boolean |
remove(URI uri, HttpCookie cookie) 从商店中删除一个cookie。 |
abstract boolean |
removeAll() 删除此Cookie存储中的所有Cookie。 |
void add (URI uri, HttpCookie cookie)
将一个HTTP cookie添加到商店。 这被称为每个传入的HTTP响应。
要存储的cookie可能会或可能不会与URI相关联。 如果它不与URI关联，则Cookie的域和路径属性将指示它来自哪里。 如果它与一个URI相关联，并且它的域和路径属性没有被指定，给定的URI将指示这个cookie来自哪里。
如果与给定的URI相对应的cookie已经存在，那么它将被替换为新的。
| Parameters | |
|---|---|
uri |
URI: the uri this cookie associated with. if null, this cookie will not be associated with an URI |
cookie |
HttpCookie: the cookie to store |
| Throws | |
|---|---|
NullPointerException |
if cookie is null |
也可以看看：
List<HttpCookie> get (URI uri)
检索与给定URI相关联的Cookie，或者其域名与给定URI相匹配的Cookie。 只返回尚未过期的Cookie。 这被称为每个传出的HTTP请求。
| Parameters | |
|---|---|
uri |
URI
|
| Returns | |
|---|---|
List<HttpCookie> |
an immutable list of HttpCookie, return empty list if no cookies match the given URI |
| Throws | |
|---|---|
NullPointerException |
if uri is null |
也可以看看：
List<HttpCookie> getCookies ()
在cookie存储中获取所有未过期的Cookie。
| Returns | |
|---|---|
List<HttpCookie> |
an immutable list of http cookies; return empty list if there's no http cookie in store |
List<URI> getURIs ()
获取标识此Cookie存储中cookie的所有URI。
| Returns | |
|---|---|
List<URI> |
an immutable list of URIs; return empty list if no cookie in this cookie store is associated with an URI |
boolean remove (URI uri, HttpCookie cookie)
从商店中删除一个cookie。
| Parameters | |
|---|---|
uri |
URI: the uri this cookie associated with. if null, the cookie to be removed is not associated with an URI when added; if not null, the cookie to be removed is associated with the given URI when added. |
cookie |
HttpCookie: the cookie to remove |
| Returns | |
|---|---|
boolean |
true if this store contained the specified cookie |
| Throws | |
|---|---|
NullPointerException |
if cookie is null |
boolean removeAll ()
删除此Cookie存储中的所有Cookie。
| Returns | |
|---|---|
boolean |
true if this store changed as a result of the call |
Android开发手册