compact1, compact2, compact3

java.net

Class CookieHandler

java.lang.Object

java.net.CookieHandler

已知直接子类：

CookieManager

public abstract class CookieHandler
extends Object

一个cookiehandler对象提供一个回调机制，把一个HTTP状态管理政策执行到HTTP协议处理程序。HTTP状态管理机构指定的方式来创建一个HTTP请求和响应的有状态会话。

全系统cookiehandler，通过HTTP协议处理程序的应用可以通过一个cookiehandler注册。setdefault（cookiehandler）。目前注册cookiehandler可以通过调用CookieHandler getdefault()检索。基于HTTP协议的状态管理的更多信息，见RFC 2965: HTTP State Management Mechanism

从以下版本开始：

一点五

构造方法摘要

构造方法

Constructor and Description
CookieHandler()

方法摘要

Modifier and Type	Method and Description
abstract Map<String,List<String>>	get(URI uri, Map<String,List<String>> requestHeaders) 从一个请求标头中指定的URI的cookie缓存中获取所有适用的饼干。
static CookieHandler	getDefault() 获取系统范围的饼干处理程序。
abstract void	put(URI uri, Map<String,List<String>> responseHeaders) 集所有适用的饼干，例如响应头域，被命名为set-cookie2，目前在响应头到一个cookie缓存。
static void	setDefault(CookieHandler cHandler) 集（或设定）系统范围的cookie处理程序。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CookieHandler

public CookieHandler()

方法详细信息

getDefault

public static CookieHandler getDefault()

获取系统范围的饼干处理程序。

结果

该系统范围的饼干处理程序；一个空的返回意味着没有系统范围的饼干处理程序。

异常

SecurityException如果安全管理器已经安装，它否认 NetPermission ("getCookieHandler")

另请参见：

setDefault(CookieHandler)

setDefault

public static void setDefault(CookieHandler cHandler)

集（或设定）系统范围的cookie处理程序。注：非标准HTTP协议处理程序可能会忽略此设置。

参数

cHandler - HTTP cookie处理程序，或 null未设置。

异常

SecurityException如果安全管理器已经安装，它否认 NetPermission ("setCookieHandler")

另请参见：

getDefault()

get

public abstract Map<String,List<String>> get(URI uri,
                                             Map<String,List<String>> requestHeaders)
                                      throws IOException

从一个请求标头中指定的URI的cookie缓存中获取所有适用的饼干。

作为一个参数传递的URI指定用途的饼干。具体的方案应该反映是否饼干将发送HTTP、HTTPS或用在另一种情况下，如JavaScript。主机部分应反映目标的饼干或者在JavaScript的案件来源。

要实现考虑到URI和饼干的属性和安全设置，以确定哪些应该归还。

HTTP协议的实施者应确保该方法添加后都选择饼干相关请求报头，并发送请求之前。

参数

uri - URI代表使用的饼干

requestHeaders -Map从请求标头字段名称列表的字段的值表示当前请求报头

结果

从国家管理的标题不变的Map，与字段名称“饼干”或“cookie2”列表包含状态信息的饼干

异常

IOException如果I/O错误发生

IllegalArgumentException -如果任一参数为null

另请参见：

put(URI, Map)

put

public abstract void put(URI uri,
                         Map<String,List<String>> responseHeaders)
                  throws IOException

集所有适用的饼干，例如响应头域，被命名为set-cookie2，目前在响应头到一个cookie缓存。

参数

uri - URI饼干是从哪里来的

responseHeaders从字段名称列表字段值代表响应头域不变的Map返回

异常

IOException如果I/O错误发生

IllegalArgumentException -如果任一参数为null

另请参见：

get(URI, Map)