com.fangcloud.sdk.http

Class StandardHttpRequestor

java.lang.Object

com.fangcloud.sdk.http.HttpRequestor

com.fangcloud.sdk.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 configure(java.net.HttpURLConnection).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	StandardHttpRequestor.Config Configuration for StandardHttpRequestor that determines how network connections to the server are established.

Nested classes/interfaces inherited from class com.fangcloud.sdk.http.HttpRequestor

HttpRequestor.Header, HttpRequestor.Response

Field Summary

Fields

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

Fields inherited from class com.fangcloud.sdk.http.HttpRequestor

DEFAULT_CONNECT_TIMEOUT_MILLIS, DEFAULT_READ_TIMEOUT_MILLIS

Constructor Summary

Constructors

Constructor and Description
StandardHttpRequestor(StandardHttpRequestor.Config config) Creates an instance that connects through the given proxy.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	configure(HttpURLConnection conn) Can be overriden to configure the underlying HttpURLConnection used to make network requests using https.
HttpRequestor.Response	doGet(String url, Iterable<HttpRequestor.Header> headers)
protected void	interceptResponse(HttpURLConnection conn) Called before returning Response from a request.
com.fangcloud.sdk.http.StandardHttpRequestor.Uploader	startPost(String url, Iterable<HttpRequestor.Header> headers)
com.fangcloud.sdk.http.StandardHttpRequestor.Uploader	startPostWithStreaming(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 StandardHttpRequestor INSTANCE

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

Constructor Detail

StandardHttpRequestor

public StandardHttpRequestor(StandardHttpRequestor.Config config)

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.fangcloud.sdk.http.StandardHttpRequestor.Uploader startPost(String url,
                                                              Iterable<HttpRequestor.Header> headers)
                                                                throws IOException

Specified by:

startPost in class HttpRequestor

Throws:

IOException

startPostWithStreaming

public com.fangcloud.sdk.http.StandardHttpRequestor.Uploader startPostWithStreaming(String url,
                                                                           Iterable<HttpRequestor.Header> headers)
                                                                             throws IOException

Specified by:

startPostWithStreaming in class HttpRequestor

Throws:

IOException

configure

protected void configure(HttpURLConnection conn)
                  throws IOException

Can be overriden to configure the underlying HttpURLConnection used to make network requests using https. Typically the connection will be a HttpsURLConnection, but that is dependent on the Java runtime. Care should be taken when casting the connection (check your JRE).

Parameters:

conn - URL connection object returned after creating an https network request.

Throws:

IOException

interceptResponse

protected void interceptResponse(HttpURLConnection conn)
                          throws IOException

Called before returning Response from a request.

This method should be used by subclasses to add any logging, analytics, or cleanup necessary. Note that the connection response code and response streams will already be fetched before calling this method. This means any IOException from reading the response should already have occurred before this method is called.

Do not consume the response or error streams in this method.

Parameters:

conn - HTTP URL connection

Throws:

IOException