HttpResponseCache

public final class HttpResponseCache
extends ResponseCache implements Closeable, OkCacheContainer

将HTTP和HTTPS响应缓存到文件系统，以便它们可以重复使用，节省时间和带宽。 该课程支持HttpURLConnection和HttpsURLConnection ; 没有平台提供的缓存DefaultHttpClient或AndroidHttpClient 。 安装和实例是线程安全的。

Installing an HTTP response cache

   protected void onCreate(Bundle savedInstanceState) {
       ...

       try {
           File httpCacheDir = new File(context.getCacheDir(), "http");
           long httpCacheSize = 10 * 1024 * 1024; // 10 MiB
           HttpResponseCache.install(httpCacheDir, httpCacheSize);
       } catch (IOException e) {
           Log.i(TAG, "HTTP response cache installation failed:" + e);
       }
   }

   protected void onStop() {
       ...

       HttpResponseCache cache = HttpResponseCache.getInstalled();
       if (cache != null) {
           cache.flush();
       }
   }

对于某些应用程序，最好在外部存储目录中创建缓存。 外部存储目录上没有访问控制，因此不应将其用于可能包含私有数据的高速缓存。 尽管它通常具有更多的可用空间，但外部存储器是可选的，即使可用，也可以在使用过程中消失。 使用getExternalCacheDir()检索外部缓存目录。 如果此方法返回null，则您的应用程序应该回退到非缓存或缓存非外部存储。 如果外部存储在使用过程中被移除，则缓存命中率将降至零，并且正在进行的缓存读取将失败。

刷新缓存强制其数据到文件系统。 这可确保写入缓存的所有响应在下次活动开始时都可读。

Cache Optimization

• Request Count: the number of HTTP requests issued since this cache was created.
• Network Count: the number of those requests that required network use.
• Hit Count: the number of those requests whose responses were served by the cache.

提高缓存命中率的最佳方法是将Web服务器配置为返回可缓存的响应。 尽管此客户端支持所有HTTP/1.1 (RFC 2068)缓存标头，但它不会缓存部分响应。

Force a Network Response

   connection.addRequestProperty("Cache-Control", "no-cache");
 

   connection.addRequestProperty("Cache-Control", "max-age=0");
 

Force a Cache Response

   try {
         connection.addRequestProperty("Cache-Control", "only-if-cached");
         InputStream cached = connection.getInputStream();
         // the resource was cached! show it
     } catch (FileNotFoundException e) {
         // the resource was not cached
     }
 

   int maxStale = 60 * 60 * 24 * 28; // tolerate 4-weeks stale
         connection.addRequestProperty("Cache-Control", "max-stale=" + maxStale);
 

Working With Earlier Releases

   try {
           File httpCacheDir = new File(context.getCacheDir(), "http");
           long httpCacheSize = 10 * 1024 * 1024; // 10 MiB
           Class.forName("android.net.http.HttpResponseCache")
                   .getMethod("install", File.class, long.class)
                   .invoke(null, httpCacheDir, httpCacheSize);
       } catch (Exception httpResponseCacheNotAvailable) {
       }

Summary

Inherited methods
From class java.net.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) 设置（或取消设置）系统级缓存。
From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为此对象调用 notify()方法或 notifyAll()方法，或者某个其他线程中断当前线程，或经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。
From interface java.io.Closeable abstract void close() 关闭此流并释放与其关联的所有系统资源。
From interface com.android.okhttp.OkCacheContainer abstract Cache getCache()
From interface java.lang.AutoCloseable abstract void close() 关闭此资源，放弃任何底层资源。

Public methods

void close ()

void delete ()

void flush ()

CacheResponse get (URI uri, 
                String requestMethod, 
                Map<String, List<String>> requestHeaders)

int getHitCount ()

HttpResponseCache getInstalled ()

int getNetworkCount ()

int getRequestCount ()

HttpResponseCache install (File directory, 
                long maxSize)

long maxSize ()

CacheRequest put (URI uri, 
                URLConnection urlConnection)

long size ()