com.sofort.lib.core.internal.net.http

Class HttpConnector

java.lang.Object

com.sofort.lib.core.internal.net.http.HttpConnector

All Implemented Interfaces:

Connector

public class HttpConnector
extends java.lang.Object
implements Connector

A default HTTP(S) connector needed to communicate with the current implementation of SofortLib API on the lowest level. The HTTP connector is a pure Java implementation of communication over HTTP(S) protocol. Defaults: POST (if content of request is not empty), UTF-8. Supports: gzip, basic authorization. For developer: can be replaced with a more powerful HTTP(S) client if needed.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	VERSION

Constructor Summary

Constructors

Constructor and Description
HttpConnector()

Method Summary

Modifier and Type	Method and Description
RawResponse	doRequest(RawRequest request, ConnectionData cd) Send the raw request using the given connection data.
protected java.net.HttpURLConnection	openConnection(HttpConnectionData connectionData) Opens the connection.
protected void	prepareConnection(java.net.HttpURLConnection connection, BasicHttpAuthorization authorization, int postDataLength) Initializes common connection settings.

Methods inherited from class java.lang.Object

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

Field Detail

VERSION

public static final java.lang.String VERSION

See Also:

Constant Field Values

Constructor Detail

HttpConnector

public HttpConnector()

Method Detail

doRequest

public RawResponse doRequest(RawRequest request,
                             ConnectionData cd)

Description copied from interface: Connector

Send the raw request using the given connection data.

Specified by:

doRequest in interface Connector

Parameters:

request - the raw request

cd - connection data needed for sending the request

Returns:

the received raw request

openConnection

protected java.net.HttpURLConnection openConnection(HttpConnectionData connectionData)
                                             throws java.io.IOException

Opens the connection.

Parameters:

connectionData - connection data with target URL the connection will be opened to.

Returns:

the opened HTTP connection

Throws:

java.io.IOException - thrown on call of URL.openConnection()

prepareConnection

protected void prepareConnection(java.net.HttpURLConnection connection,
                                 BasicHttpAuthorization authorization,
                                 int postDataLength)
                          throws java.net.ProtocolException

Initializes common connection settings.

Parameters:

connection - opened HTTP connection

authorization - the basic HTTP authorization

postDataLength - the length of the data to be posted, used for setting the proper value of the Content-Length header

Throws:

java.net.ProtocolException - thrown exception on wrong call of HttpURLConnection.setRequestMethod(String)