程序包 ohos.net

类 HttpResponseCache

java.lang.Object

java.net.ResponseCache

ohos.net.HttpResponseCache

public final class HttpResponseCache
extends ResponseCache

Caches HTTP and HTTPS responses for reuse.

从以下版本开始:

1

方法概要

限定符和类型	方法	说明
void	close()	Disables a cache without changing the data in it.
void	delete()	Disables a cache and deletes the data in it.
void	flush()	Writes data in the cache to the file system so that all the cached data can be accessed in the next HTTP request.
CacheResponse	get(URI uri, String rqstMethod, Map<String,List<String>> rqstHeaders)	Retrieve the cached response based on the requesting uri, request method and request headers.
int	getHitCount()	Obtains the number of times the cached data is accessed.
static HttpResponseCache	getInstalled()	Obtains the HttpResponseCache object.
long	getMaxSize()	Obtains the maximum number of bytes in a cache.
int	getNetworkCount()	Obtains the number of HTTP requests.
int	getRequestCount()	Obtains the number of HTTP requests after a cache is created.
long	getSize()	Obtains the number of bytes in a cache.
static HttpResponseCache	install(File directory, long size)	Creates a default HttpResponseCache object to store the responses of HTTP access requests.
CacheRequest	put(URI uri, URLConnection conn)	The protocol handler calls this method after a resource has been retrieved, and the ResponseCache must decide whether or not to store the resource in its cache.

从类继承的方法 java.lang.Object

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

从类继承的方法 java.net.ResponseCache

getDefault, setDefault

方法详细资料

getInstalled

public static HttpResponseCache getInstalled()

Obtains the HttpResponseCache object.

返回:

Returns the HttpResponseCache object.

从以下版本开始:

1

install

public static HttpResponseCache install(File directory,
                                        long size)
                                 throws IOException

Creates a default HttpResponseCache object to store the responses of HTTP access requests.

参数:

directory - Indicates the directory for storing the cached data.

size - Indicates the maximum size of the cached data.

返回:

the newly-installed cache

抛出:

IOException - Throws this exception if the cache cannot be accessed.

从以下版本开始:

1

get

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

从类复制的说明: ResponseCache

Retrieve the cached response based on the requesting uri, request method and request headers. Typically this method is called by the protocol handler before it sends out the request to get the network resource. If a cached response is returned, that resource is used instead.

指定者:

get 在类中 ResponseCache

参数:

uri - a URI used to reference the requested network resource

rqstMethod - a String representing the request method

rqstHeaders - - a Map from request header field names to lists of field values representing the current request headers

返回:

a CacheResponse instance if available from cache, or null otherwise

抛出:

IOException - if an I/O error occurs

另请参阅:

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

put

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

从类复制的说明: ResponseCache

The protocol handler calls this method after a resource has been retrieved, and the ResponseCache must decide whether or not to store the resource in its cache. If the resource is to be cached, then put() must return a CacheRequest object which contains an OutputStream that the protocol handler will use to write the resource into the cache. If the resource is not to be cached, then put must return null.

指定者:

put 在类中 ResponseCache

参数:

uri - a URI used to reference the requested network resource

conn - - a URLConnection instance that is used to fetch the response to be cached

返回:

a CacheRequest for recording the response to be cached. Null return indicates that the caller does not intend to cache the response.

抛出:

IOException - if an I/O error occurs

getSize

public long getSize()
             throws IOException

Obtains the number of bytes in a cache.

返回:

Returns the number of bytes in the cache.

抛出:

IOException - Throws this exception if the cache cannot be accessed.

从以下版本开始:

1

getMaxSize

public long getMaxSize()

Obtains the maximum number of bytes in a cache.

返回:

Returns the maximum number of bytes in the cache.

从以下版本开始:

1

flush

public void flush()
           throws IOException

Writes data in the cache to the file system so that all the cached data can be accessed in the next HTTP request.

抛出:

IOException - Throws this exception if the cache cannot be accessed.

从以下版本开始:

1

getNetworkCount

public int getNetworkCount()

Obtains the number of HTTP requests.

返回:

Returns the number of HTTP requests.

从以下版本开始:

1

getHitCount

public int getHitCount()

Obtains the number of times the cached data is accessed.

返回:

Returns the number of times the cached data is accessed.

从以下版本开始:

1

getRequestCount

public int getRequestCount()

Obtains the number of HTTP requests after a cache is created.

返回:

Returns the number of HTTP requests after a cache is created.

从以下版本开始:

1

close

public void close()
           throws IOException

Disables a cache without changing the data in it.

抛出:

IOException - Throws this exception if the cache cannot be accessed.

从以下版本开始:

1

delete

public void delete()
            throws IOException

Disables a cache and deletes the data in it.

抛出:

IOException - Throws this exception if the cache cannot be accessed.

从以下版本开始:

1