java.net
類別 CookieHandler

java.lang.Object
  java.net.CookieHandler

直接已知子類別：

CookieManager

public abstract class CookieHandler
extends Object

CookieHandler 物件提供一種回調機制以將 HTTP 狀態管理策略實作掛鉤到 HTTP 協議處理程序。HTTP 狀態管理機制利用 HTTP 請求和回應指定創建有狀態的Session的方式。

可以通過執行 CookieHandler.setDefault(CookieHandler) 來註冊 HTTP 協議處理程序要使用的系統級 CookieHandler。調用 CookieHandler.getDefault() 可以獲取當前註冊的 CookieHandler。 有關 HTTP 狀態管理的更多資訊，請參見 RFC 2965: HTTP 狀態管理機制

從以下版本開始：

1.5

建構子摘要

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

建構子詳細資訊

CookieHandler

public CookieHandler()

方法詳細資訊

getDefault

public static CookieHandler getDefault()

獲取系統級 cookie 處理程序。

返回：

系統級 cookie 處理程序；返回 null 表示當前沒有設置任何系統級 cookie 處理程序。

拋出：

SecurityException - 如果安裝了安全管理器並且它拒絕 NetPermission<tt>("getCookieHandler")</tt>

另請參見：

setDefault(CookieHandler)

setDefault

public static void setDefault(CookieHandler cHandler)

設置（或取消設置）系統級 cookie 處理程序。 註：非標準 http 協議處理程序可能忽略此設置。

參數：

cHandler - HTTP cookie 處理程序；或者 <code>null</code>，表示取消設置。

拋出：

SecurityException - 如果安裝了安全管理器並且它拒絕 NetPermission<tt>("setCookieHandler")</tt>

另請參見：

getDefault()

get

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

從請求頭中指定 uri 的 cookie 快取記憶體中獲取所有可用的 cookie。 HTTP 協議實作程序應該確保在添加所有與選擇 cookie 相關的請求頭之後且在發送請求之前調用此方法。

參數：

uri - 作為請求中 cookie 發送目標的 <code>URI</code>

requestHeaders - 從請求頭欄位名到表示當前請求頭的欄位值列表的 Map

返回：

從欄位名為 "Cookie" 或 "Cookie2" 的狀態管理頭到包含狀態資訊的 cookie 列表的映射

拋出：

IOException - 如果發生 I/O * 錯誤

IllegalArgumentException - 如果其中任意一個參數為 null

另請參見：

put(URI, Map)

put

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

將回應頭中出現的所有可用 cookie（例如名為 Set-Cookie2 的回應頭欄位）設置到 cookie 快取記憶體中。

參數：

uri - <code>URI</code>，cookie 來自其中

responseHeaders - 從欄位名到表示返回的回應頭欄位的欄位值列表的不可變映射

拋出：

IOException - 如果發生 I/O 錯誤

IllegalArgumentException - 如果其中任意一個參數為 null

另請參見：

get(URI, Map)