com.dropbox.core.http

Class StandardHttpRequestor

java.lang.Object

com.dropbox.core.http.HttpRequestor

com.dropbox.core.http.StandardHttpRequestor

public class StandardHttpRequestor
extends HttpRequestor

HttpRequestor implementation that uses Java's standard library HttpsURLConnection. If you just want a connection with the default settings, use the predefined Instance.

If you want to customize the way the connection is configured, create a subclass that overrides configureConnection(javax.net.ssl.HttpsURLConnection).

Nested Class Summary

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

HttpRequestor.Header, HttpRequestor.Response

Field Summary

Fields

Modifier and Type	Field and Description
static int	DefaultConnectTimeoutMillis We pass this value to URLConnection.setConnectTimeout(int).
static int	DefaultReadTimeoutMillis We pass this value to URLConnection.setReadTimeout(int).
static StandardHttpRequestor	Instance A thread-safe instance of StandardHttpRequestor that connects directly (as opposed to using a proxy).

Constructor Summary

Constructors

Constructor and Description
StandardHttpRequestor() Creates an instance that uses a direct HTTP connection (as opposed to using a proxy).
StandardHttpRequestor(Proxy proxy) Creates an instance that connects through the given proxy.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	configureConnection(HttpsURLConnection conn) Can be overridden to configure the underlying HttpsURLConnection used to make network requests.
HttpRequestor.Response	doGet(String url, Iterable<HttpRequestor.Header> headers)
com.dropbox.core.http.StandardHttpRequestor.Uploader	startPost(String url, Iterable<HttpRequestor.Header> headers)
com.dropbox.core.http.StandardHttpRequestor.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

DefaultConnectTimeoutMillis

public static final int DefaultConnectTimeoutMillis

We pass this value to URLConnection.setConnectTimeout(int). You can change this setting by creating a subclass and overriding configureConnection(javax.net.ssl.HttpsURLConnection).

See Also:

Constant Field Values

DefaultReadTimeoutMillis

public static final int DefaultReadTimeoutMillis

We pass this value to URLConnection.setReadTimeout(int). You can change this setting by creating a subclass and overriding configureConnection(javax.net.ssl.HttpsURLConnection).

See Also:

Constant Field Values

Instance

public static final StandardHttpRequestor Instance

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

Constructor Detail

StandardHttpRequestor

public StandardHttpRequestor()

Creates an instance that uses a direct HTTP connection (as opposed to using a proxy).

StandardHttpRequestor

public StandardHttpRequestor(Proxy proxy)

Creates an instance that connects through the given proxy.

Method Detail

doGet

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

Specified by:

doGet in class HttpRequestor

Throws:

IOException

startPost

public com.dropbox.core.http.StandardHttpRequestor.Uploader startPost(String url,
                                                             Iterable<HttpRequestor.Header> headers)
                                                               throws IOException

Specified by:

startPost in class HttpRequestor

Throws:

IOException

startPut

public com.dropbox.core.http.StandardHttpRequestor.Uploader startPut(String url,
                                                            Iterable<HttpRequestor.Header> headers)
                                                              throws IOException

Specified by:

startPut in class HttpRequestor

Throws:

IOException

configureConnection

protected void configureConnection(HttpsURLConnection conn)
                            throws IOException

Can be overridden to configure the underlying HttpsURLConnection used to make network requests. If you override this method, you should probably call super.configureConnection(conn) in your overridden method.

Throws:

IOException