- java.lang.Object
-
- java.net.ResponseCache
-
public abstract class ResponseCache extends Object
表示URLConnection缓存的实现。 可以通过执行ResponseCache.setDefault(ResponseCache)向系统注册此类的实例,并且系统将调用此对象以便:- 将从外部源检索的资源数据存储到高速缓存中
- 尝试获取可能存储在缓存中的请求资源
- 从以下版本开始:
- 1.5
-
-
构造方法摘要
构造方法 Constructor 描述 ResponseCache()
-
方法摘要
所有方法 静态方法 接口方法 抽象方法 具体的方法 Modifier and Type 方法 描述 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)
设置(或取消)系统级缓存。
-
-
-
方法详细信息
-
getDefault
public static ResponseCache getDefault()
获取系统范围的响应缓存。- 结果
-
系统范围
ResponseCache
- 异常
-
SecurityException
- 如果已安装安全管理员,并且它已拒绝NetPermission
("getResponseCache")
- 从以下版本开始:
- 1.5
- 另请参见:
-
setDefault(ResponseCache)
-
setDefault
public static void setDefault(ResponseCache responseCache)
设置(或取消)系统级缓存。 注意:非标准procotol处理程序可能会忽略此设置。- 参数
-
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
实例,如果从缓存可用,否则为空 - 异常
-
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,协议处理程序用于将资源写入高速缓存。 如果资源不被缓存,那么put必须返回null。- 参数
-
uri
- 一个URI
用于引用请求的网络资源 -
conn
- 用于获取要缓存的响应的URLConnection实例 - 结果
-
一个用于记录要缓存的响应的
CacheRequest
。 空返回表示呼叫者不打算缓存响应。 - 异常
-
IOException
- 如果发生I / O错误 -
IllegalArgumentException
- 如果任何一个参数为空
-
-