com.dropbox.core.http

Class OkHttpRequestor

java.lang.Object

com.dropbox.core.http.HttpRequestor

com.dropbox.core.http.OkHttpRequestor

public class OkHttpRequestor
extends HttpRequestor

HttpRequestor implementation that uses OkHttp v2. You can only use this if your project includes the OkHttp v2 library.

To use OkHttp v3, see OkHttp3Requestor.

To use this, pass INSTANCE to the DbxRequestConfig constructor.

See Also:

OkHttp3Requestor

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	OkHttpRequestor.AsyncCallback

Nested classes/interfaces inherited from class com.dropbox.core.http.HttpRequestor

HttpRequestor.Header, HttpRequestor.Response, HttpRequestor.Uploader

Field Summary

Fields

Modifier and Type	Field and Description
static OkHttpRequestor	INSTANCE A thread-safe instance of OkHttpRequestor that connects directly (as opposed to using a proxy).

Fields inherited from class com.dropbox.core.http.HttpRequestor

DEFAULT_CONNECT_TIMEOUT_MILLIS, DEFAULT_READ_TIMEOUT_MILLIS

Constructor Summary

Constructors

Constructor and Description
OkHttpRequestor(com.squareup.okhttp.OkHttpClient client) Creates a new instance of this requestor that uses client for its requests.

Method Summary

Modifier and Type	Method and Description
protected void	configureRequest(com.squareup.okhttp.Request.Builder request) Called beforing building the request and executing it.
HttpRequestor.Response	doGet(String url, Iterable<HttpRequestor.Header> headers)
com.squareup.okhttp.OkHttpClient	getClient() Returns a clone of the underlying OkHttpClient used to make requests.
protected com.squareup.okhttp.Response	interceptResponse(com.squareup.okhttp.Response response) Called before returning Response from a request.
HttpRequestor.Uploader	startPost(String url, Iterable<HttpRequestor.Header> headers)
HttpRequestor.Uploader	startPut(String url, Iterable<HttpRequestor.Header> headers)

Methods inherited from class java.lang.Object

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

Field Detail

INSTANCE

public static final OkHttpRequestor INSTANCE

A thread-safe instance of OkHttpRequestor that connects directly (as opposed to using a proxy).

Constructor Detail

OkHttpRequestor

public OkHttpRequestor(com.squareup.okhttp.OkHttpClient client)

Creates a new instance of this requestor that uses client for its requests.

The OkHttpClient will be cloned to prevent further modification.

NOTE: This constructor will not enable certificate pinning on the client. If you want certificate pinning, use the default instance, INSTANCE, or clone the default client and modify it accordingly:

NOTE: This SDK requires that OkHttp clients do not use same-thread executors for issuing calls. The SDK relies on the assumption that all asynchronous calls will actually be executed asynchronously. Using a same-thread executor for your OkHttp client may result in dead-locks.

     OkHttpClient client = OkHttpRequestor.INSTANCE.getClient(); // returns a clone
     client.setReadTimeout(2, TimeUnit.MINUTES);
     // ... other modifications
     HttpRequestor requestor = new OkHttpRequestor(client);
 

Parameters:

client - OkHttpClient to use for requests (will be cloned), never null

Throws:

IllegalArgumentException - if client uses a same-thread executor for its dispatcher

Method Detail

getClient

public com.squareup.okhttp.OkHttpClient getClient()

Returns a clone of the underlying OkHttpClient used to make requests. If you want to modify the client for a particular request, create a new instance of this requestor with the modified client.

Returns:

clone of the underlying OkHttpClient used by this requestor.

configureRequest

protected void configureRequest(com.squareup.okhttp.Request.Builder request)

Called beforing building the request and executing it.

This method should be used by subclasses to make any changes or additions to the request before it is issued.

Parameters:

request - Builder of request to be executed

interceptResponse

protected com.squareup.okhttp.Response interceptResponse(com.squareup.okhttp.Response response)

Called before returning Response from a request.

This method should be used by subclasses to add any logging, analytics, or cleanup necessary.

If the response body is consumed, it should be replaced.

Parameters:

response - OkHttp response

Returns:

OkHttp response

doGet

public HttpRequestor.Response doGet(String url,
                                    Iterable<HttpRequestor.Header> headers)
                             throws IOException

Specified by:

doGet in class HttpRequestor

Throws:

IOException

startPost

public HttpRequestor.Uploader startPost(String url,
                                        Iterable<HttpRequestor.Header> headers)
                                 throws IOException

Specified by:

startPost in class HttpRequestor

Throws:

IOException

startPut

public HttpRequestor.Uploader startPut(String url,
                                       Iterable<HttpRequestor.Header> headers)
                                throws IOException

Specified by:

startPut in class HttpRequestor

Throws:

IOException