com.dropbox.core.http

Class OkHttp3Requestor

java.lang.Object

com.dropbox.core.http.HttpRequestor

com.dropbox.core.http.OkHttp3Requestor

public class OkHttp3Requestor
extends HttpRequestor

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

To use this, pass INSTANCE to the DbxRequestConfig constructor.

Nested Class Summary

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 OkHttp3Requestor	INSTANCE A thread-safe instance of OkHttp3Requestor 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
OkHttp3Requestor(okhttp3.OkHttpClient client) Creates a new instance of this requestor that uses client for its requests.

Method Summary

Modifier and Type	Method and Description
HttpRequestor.Response	doGet(String url, Iterable<HttpRequestor.Header> headers)
okhttp3.OkHttpClient	getClient() Returns the underlying OkHttpClient used to make requests.
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 OkHttp3Requestor INSTANCE

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

Constructor Detail

OkHttp3Requestor

public OkHttp3Requestor(okhttp3.OkHttpClient client)

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

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:

     OkHttpClient client = OkHttpRequestor.INSTANCE.getClient()
         .readTimeout(2, TimeUnit.MINUTES)
         // ... other modifications
         .build();
     HttpRequestor requestor = new OkHttpRequestor(client);
 

Parameters:

client - OkHttpClient to use for requests, never null

Method Detail

getClient

public okhttp3.OkHttpClient getClient()

Returns 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:

underlying OkHttpClient used by this requestor.

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