public abstract class CookieHandler
extends Object
| java.lang.Object | |
| ↳ | java.net.CookieHandler |
 Known Direct Subclasses
|
CookieHandler对象提供回调机制，将HTTP状态管理策略实现挂接到HTTP协议处理程序中。 HTTP状态管理机制指定了一种用HTTP请求和响应来创建有状态会话的方式。
可以通过执行CookieHandler.setDefault（CookieHandler）来注册由HTTP协议处理程序使用的全系统CookieHandler。 通过调用CookieHandler.getDefault（）可以检索当前注册的CookieHandler。 有关HTTP状态管理的更多信息，请参阅RFC 2965: HTTP State Management Mechanism
Public constructors |
|
|---|---|
CookieHandler() |
|
Public methods |
|
|---|---|
abstract Map<String, List<String>> |
get(URI uri, Map<String, List<String>> requestHeaders) 从请求标头中指定的URI获取cookie缓存中的所有适用cookie。 |
static CookieHandler |
getDefault() 获取系统范围的Cookie处理程序。 |
abstract void |
put(URI uri, Map<String, List<String>> responseHeaders) 设置所有适用的cookie，例如响应头中的响应头字段（名为Set-Cookie2），并显示在cookie缓存中。 |
static void |
setDefault(CookieHandler cHandler) 设置（或取消设置）系统范围的Cookie处理程序。 |
Inherited methods |
|
|---|---|
From class java.lang.Object
|
|
Map<String, List<String>> get (URI uri, Map<String, List<String>> requestHeaders)
从请求标头中指定的URI获取cookie缓存中的所有适用cookie。
作为参数传递的URI指定了cookie的预期用途。 特别是该计划应反映cookie是通过http，https发送还是用于其他背景（如javascript）。 主机部分应该反映cookie的目的地或者javascript的来源。
考虑到 URI以及cookie属性和安全设置以确定哪些应该返回，这取决于实施。
HTTP协议实现者应确保在添加了与选择cookie相关的所有请求标头之后并在请求发送之前调用此方法。
| Parameters | |
|---|---|
uri |
URI: a URI representing the intended use for the cookies |
requestHeaders |
Map: - a Map from request header field names to lists of field values representing the current request headers |
| Returns | |
|---|---|
Map<String, List<String>> |
an immutable map from state management headers, with field names "Cookie" or "Cookie2" to a list of cookies containing state information |
| Throws | |
|---|---|
IOException |
if an I/O error occurs |
IllegalArgumentException |
if either argument is null |
也可以看看：
CookieHandler getDefault ()
获取系统范围的Cookie处理程序。
| Returns | |
|---|---|
CookieHandler |
the system-wide cookie handler; A null return means there is no system-wide cookie handler currently set. |
| Throws | |
|---|---|
SecurityException |
If a security manager has been installed and it denies NetPermission("getCookieHandler") |
也可以看看：
void put (URI uri, Map<String, List<String>> responseHeaders)
设置所有适用的cookie，例如响应头中的响应头字段（名为Set-Cookie2），并显示在cookie缓存中。
| Parameters | |
|---|---|
uri |
URI: a URI where the cookies come from |
responseHeaders |
Map: an immutable map from field names to lists of field values representing the response header fields returned |
| Throws | |
|---|---|
IOException |
if an I/O error occurs |
IllegalArgumentException |
if either argument is null |
也可以看看：
void setDefault (CookieHandler cHandler)
设置（或取消设置）系统范围的Cookie处理程序。 注意：非标准的http协议处理程序可能会忽略此设置。
| Parameters | |
|---|---|
cHandler |
CookieHandler: The HTTP cookie handler, or null to unset. |
| Throws | |
|---|---|
SecurityException |
If a security manager has been installed and it denies NetPermission("setCookieHandler") |
也可以看看：
Android开发手册