Package com.squareup.okhttp

Interface OkResponseCache

All Known Implementing Classes:

OkResponseCacheAdapter

public interface OkResponseCache

An extended response cache API. Unlike ResponseCache, this interface supports conditional caching and statistics.

Warning: Experimental OkHttp 2.0 API

This class is in beta. APIs are subject to change!

Method Summary

Modifier and Type	Method	Description
CacheResponse	get(URI uri, String requestMethod, Map<String,List<String>> requestHeaders)
void	maybeRemove(String requestMethod, URI uri)	Remove any cache entries for the supplied uri if the request method invalidates.
CacheRequest	put(URI uri, URLConnection urlConnection)
void	trackConditionalCacheHit()	Track an conditional GET that was satisfied by this cache.
void	trackResponse(ResponseSource source)	Track an HTTP response being satisfied by source.
void	update(CacheResponse conditionalCacheHit, HttpURLConnection connection)	Handles a conditional request hit by updating the stored cache response with the headers from httpConnection.

Method Details

get

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

Throws:

IOException

put

CacheRequest put(URI uri,
URLConnection urlConnection)
          throws IOException

Throws:

IOException

maybeRemove

void maybeRemove(String requestMethod,
URI uri)
          throws IOException

Remove any cache entries for the supplied uri if the request method invalidates.

Throws:

IOException

update

void update(CacheResponse conditionalCacheHit,
HttpURLConnection connection)
     throws IOException

Handles a conditional request hit by updating the stored cache response with the headers from httpConnection. The cached response body is not updated. If the stored response has changed since conditionalCacheHit was returned, this does nothing.

Throws:

IOException

trackConditionalCacheHit

void trackConditionalCacheHit()

Track an conditional GET that was satisfied by this cache.

trackResponse

void trackResponse(ResponseSource source)

Track an HTTP response being satisfied by source.