compact1, compact2, compact3

java.net

Class ResponseCache

java.lang.Object

java.net.ResponseCache

public abstract class ResponseCache
extends Object

代表URLConnection缓存的实现。这样的一个类的实例可以注册系统做responsecache。setdefault（responsecache），和系统将调用此对象为：

• 已从外部资源检索到高速缓存的存储资源数据
• 尝试获取可能已存储在缓存中的请求资源

的responsecache实施决定哪些资源应该被缓存，以及多久他们应该被缓存。如果从缓存中检索到请求资源，则协议处理程序将从其原始位置提取资源。为usecaches URLConnection #控制协议是否允许使用缓存的响应的设置。对于HTTP缓存的更多信息，见 RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1

从以下版本开始：

一点五

构造方法摘要

构造方法

Constructor and Description
ResponseCache()

方法摘要

Modifier and Type	Method and Description
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) 集（或设定）全系统缓存。

Methods inherited from class java.lang.Object

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

Constructor Detail

ResponseCache

public ResponseCache()

方法详细信息

getDefault

public static ResponseCache getDefault()

获取系统宽响应缓存。

结果

全系统 ResponseCache

异常

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

从以下版本开始：

一点五

另请参见：

setDefault(ResponseCache)

setDefault

public static void setDefault(ResponseCache responseCache)

集（或设定）全系统缓存。注：非标准协议处理程序可能会忽略此设置。

参数

responseCache -响应缓存，或 null未设置缓存。

异常

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

从以下版本开始：

一点五

另请参见：

getDefault()

get

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

检索缓存的响应基于请求的URI请求方法、请求报头。通常这种方法在发送请求之前被协议处理程序调用，以获取网络资源。如果返回缓存响应，则使用该资源而不是。

参数

uri -用来请求网络资源参考 URI

rqstMethod - String表示请求的方法

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

结果

一个 CacheResponse如果可以从缓存，或空否则

异常

IOException如果I/O错误发生

IllegalArgumentException -如果参数的任何一个是空的

另请参见：

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

put

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

协议处理程序调用此方法后，资源已被检索，和responsecache必须决定是否存储在缓存中的资源。如果资源被缓存，然后put()必须返回一个对象，其中包含CacheRequest OutputStream，协议处理程序将使用资源的缓存写。如果资源不被缓存，则放必须返回空值。

参数

uri -用来请求网络资源参考 URI

conn --一个URLConnection实例，用于获取被缓存的响应

结果

用于记录被缓存的响应 CacheRequest。返回值指示调用方不打算缓存响应。

异常

IOException如果I/O错误发生

IllegalArgumentException -如果参数的任何一个是空的