com.squareup.okhttp

Interface OkResponseCache

All Known Implementing Classes:

HttpResponseCache

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

Methods

Modifier and Type	Method and Description
com.squareup.okhttp.internal.http.Response	get(com.squareup.okhttp.internal.http.Request request)
boolean	maybeRemove(com.squareup.okhttp.internal.http.Request request) Remove any cache entries for the supplied uri.
CacheRequest	put(com.squareup.okhttp.internal.http.Response response)
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(com.squareup.okhttp.internal.http.Response cached, com.squareup.okhttp.internal.http.Response network) Handles a conditional request hit by updating the stored cache response with the headers from network.

Method Detail

get

com.squareup.okhttp.internal.http.Response get(com.squareup.okhttp.internal.http.Request request)
                                               throws IOException

Throws:

IOException

put

CacheRequest put(com.squareup.okhttp.internal.http.Response response)
                 throws IOException

Throws:

IOException

maybeRemove

boolean maybeRemove(com.squareup.okhttp.internal.http.Request request)
                    throws IOException

Remove any cache entries for the supplied uri. Returns true if the supplied requestMethod potentially invalidates an entry in the cache.

Throws:

IOException

update

void update(com.squareup.okhttp.internal.http.Response cached,
          com.squareup.okhttp.internal.http.Response network)
            throws IOException

Handles a conditional request hit by updating the stored cache response with the headers from network. The cached response body is not updated. If the stored response has changed since cached 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.