java.net
類別 ResponseCache

java.lang.Object
  java.net.ResponseCache

public abstract class ResponseCache
extends Object

表示 URLConnection 快取記憶體的實作。這種類別的實例可以通過執行 ResponseCache.setDefault(ResponseCache) 向系統註冊，系統將調用此物件以便：

• 將從外部源獲得的資源資料存儲到快取記憶體中
• 試圖獲取可能存儲在快取記憶體中的請求資源

ResponseCache 實作決定應該快取記憶體的資源和快取記憶體它們的時間。如果無法從快取記憶體獲得請求資源，則協議處理程序將從其初始位置獲取該資料。 URLConnection#useCaches 的設置控制著是否允許協議使用快取記憶體的回應。 有關 HTTP 快取記憶體的更多資訊，請參見 RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1。

從以下版本開始：

1.5

建構子摘要

ResponseCache()

方法摘要

abstract CacheResponse	get(URI uri, String rqstMethod, Map<String,List<String>> rqstHeaders) 根據請求的 uri、請求方法和請求頭獲取快取記憶體的回應。
static ResponseCache	getDefault() 獲取系統級回應快取記憶體。
abstract CacheRequest	put(URI uri, URLConnection conn) 協議處理程序在獲得資源後調用此方法，ResponseCache 必須決定是否在其快取記憶體中存儲資源。
static void	setDefault(ResponseCache responseCache) 設置（或取消設置）系統級快取記憶體。

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

ResponseCache

public ResponseCache()

方法詳細資訊

getDefault

public static ResponseCache getDefault()

獲取系統級回應快取記憶體。

返回：

系統級 ResponseCache

拋出：

SecurityException - 如果安裝了安全管理器並且它拒絕 NetPermission("getResponseCache")

從以下版本開始：

1.5

另請參見：

setDefault(ResponseCache)

setDefault

public static void setDefault(ResponseCache responseCache)

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

參數：

responseCache - 回應快取記憶體，或者為 null，表示取消設置快取記憶體。

拋出：

SecurityException - 如果安裝了安全管理器並且它拒絕 NetPermission("setResponseCache")

從以下版本開始：

1.5

另請參見：

getDefault()

get

public abstract CacheResponse get(URI uri,
                                  String rqstMethod,
                                  Map<String,List<String>> rqstHeaders)
                           throws IOException

根據請求的 uri、請求方法和請求頭獲取快取記憶體的回應。通常，此方法由協議處理程序在發出獲取網路資源的請求之前調用。如果返回快取記憶體的回應，則改為使用該資源。

參數：

uri - 用於參考所請求的網路資源的 URI

rqstMethod - 表示請求方法的 String

rqstHeaders - 從請求頭欄位名稱到表示當前請求頭的欄位值列表的映射

返回：

CacheResponse 實例，如果可從快取記憶體中得到；否則返回 null

拋出：

IOException - 如果發生 I/O 錯誤

IllegalArgumentException - 如果參數中的任何一個為 null

另請參見：

URLConnection.setUseCaches(boolean), URLConnection.getUseCaches(), URLConnection.setDefaultUseCaches(boolean), URLConnection.getDefaultUseCaches()

put

public abstract CacheRequest put(URI uri,
                                 URLConnection conn)
                          throws IOException

協議處理程序在獲得資源後調用此方法，ResponseCache 必須決定是否在其快取記憶體中存儲資源。如果快取記憶體資源，則 put() 必須返回 CacheRequest 物件，該物件包含協議處理程序用來將資源寫入快取記憶體的 WriteableByteChannel。如果不快取記憶體資源，則 put 必須返回 null。

參數：

uri - 用於參考所請求的網路資源的 URI

conn - 用於獲取要快取記憶體的回應的 URLConnection 實例

返回：

用於記錄要快取記憶體的回應的 CacheRequest。返回 null 指示調用方不打算快取記憶體回應。

拋出：

IOException - 如果發生 I/O 錯誤

IllegalArgumentException - 如果參數中的任何一個為 null