java.lang.Object java.net.CookieHandler
public abstract class CookieHandler
CookieHandler 对象提供一种回调机制以将 HTTP 状态管理策略实现挂钩到 HTTP 协议处理程序。HTTP 状态管理机制利用 HTTP 请求和响应指定创建有状态的会话的方式。
可以通过执行 CookieHandler.setDefault(CookieHandler) 来注册 HTTP 协议处理程序要使用的系统级 CookieHandler。调用 CookieHandler.getDefault() 可以获取当前注册的 CookieHandler。 有关 HTTP 状态管理的更多信息,请参见 RFC 2965: HTTP 状态管理机制
构造方法摘要 | |
---|---|
CookieHandler() |
方法摘要 | |
---|---|
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 处理程序。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
构造方法详细信息 |
---|
public CookieHandler()
方法详细信息 |
---|
public static CookieHandler getDefault()
SecurityException
- 如果安装了安全管理器并且它拒绝
NetPermission
<tt>("getCookieHandler")</tt>
setDefault(CookieHandler)
public static void setDefault(CookieHandler cHandler)
cHandler
- HTTP cookie 处理程序;或者 <code>null</code>,表示取消设置。
SecurityException
- 如果安装了安全管理器并且它拒绝
NetPermission
<tt>("setCookieHandler")</tt>
getDefault()
public abstract Map<String,List<String>> get(URI uri, Map<String,List<String>> requestHeaders) throws IOException
uri
- 作为请求中 cookie 发送目标的 <code>URI</code>
requestHeaders
- 从请求头字段名到表示当前请求头的字段值列表的 Map
IOException
- 如果发生 I/O * 错误
IllegalArgumentException
- 如果其中任意一个参数为 null
put(URI, Map)
public abstract void put(URI uri, Map<String,List<String>> responseHeaders) throws IOException
uri
- <code>URI</code>,cookie 来自其中
responseHeaders
- 从字段名到表示返回的响应头字段的字段值列表的不可变映射
IOException
- 如果发生 I/O 错误
IllegalArgumentException
- 如果其中任意一个参数为 null
get(URI, Map)