com.microsoft.azure.sdk.iot.device.transport.https

Class HttpsConnection

java.lang.Object

com.microsoft.azure.sdk.iot.device.transport.https.HttpsConnection

public class HttpsConnection
extends java.lang.Object

A wrapper for the Java SE class HttpsURLConnection. Used to avoid compatibility issues when testing with the mocking framework JMockit, as well as to avoid some undocumented side effects when using HttpsURLConnection.

The underlying HttpsURLConnection is transparently managed by Java. To reuse connections, for each time connect() is called, the input streams (input stream or error stream, if input stream is not accessible) must be completely read. Otherwise, the data remains in the stream and the connection will not be reusable.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	HttpsConnection()
	HttpsConnection(java.net.URL url, HttpsMethod method) Constructor.
	HttpsConnection(java.net.URL url, HttpsMethod method, ProxySettings proxySettings) Constructor.
	HttpsConnection(java.net.URL url, HttpsMethod method, ProxySettings proxySettings, boolean isHttps) Constructor.

Method Summary

Modifier and Type	Method and Description
void	connect() Sends the request to the URL given in the constructor.
java.util.Map<java.lang.String,java.util.List<java.lang.String>>	getResponseHeaders() Returns the response headers as a Map, where the key is the header field name and the values are the values associated with the header field name.
int	getResponseStatus() Returns the response status code.
byte[]	readError() Reads from the error stream and returns the error reason.
byte[]	readInput() Reads from the input stream (response stream) and returns the response.
void	setConnectTimeout(int timeout) Sets the connect timeout in milliseconds.
void	setReadTimeout(int timeout) Sets the read timeout in milliseconds.
void	setRequestHeader(java.lang.String field, java.lang.String value) Sets the request header field to the given value.
void	setRequestMethod(HttpsMethod method) Sets the request method (i.e.
void	writeOutput(byte[] body) Saves the body to be sent with the request.

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpsConnection

public HttpsConnection(java.net.URL url,
                       HttpsMethod method)
                throws TransportException

Constructor. Opens a connection to the given URL. Can be HTTPS or HTTP

Parameters:

url - the URL for the HTTP/HTTPS connection.

method - the HTTP method (i.e. GET).

Throws:

TransportException - if the connection could not be opened.

HttpsConnection

public HttpsConnection(java.net.URL url,
                       HttpsMethod method,
                       ProxySettings proxySettings)
                throws TransportException

Constructor. Opens a connection to the given URL. Can be HTTPS or HTTP

Parameters:

url - the URL for the HTTP/HTTPS connection.

method - the HTTP method (i.e. GET).

proxySettings - The proxy settings to use when connecting. If null, then no proxy will be used

Throws:

TransportException - if the connection could not be opened.

HttpsConnection

public HttpsConnection(java.net.URL url,
                       HttpsMethod method,
                       ProxySettings proxySettings,
                       boolean isHttps)
                throws TransportException

Constructor. Opens a connection to the given URL. Can be HTTPS or HTTP

Parameters:

url - the URL for the HTTP/HTTPS connection.

method - the HTTP method (i.e. GET).

proxySettings - The proxy settings to use when connecting. If null, then no proxy will be used

isHttps - if true, then this request is an https request as opposed to an http request

Throws:

TransportException - if the connection could not be opened.

HttpsConnection

protected HttpsConnection()

Method Detail

connect

public void connect()
             throws TransportException

Sends the request to the URL given in the constructor.

Throws:

TransportException - if the connection could not be established, or the server responded with a bad status code.

setRequestMethod

public void setRequestMethod(HttpsMethod method)
                      throws TransportException

Sets the request method (i.e. POST).

Parameters:

method - the request method.

Throws:

TransportException - if the request currently has a non-empty body and the new method is not a POST or a PUT. This is because Java's HttpsURLConnection silently converts the HTTPS method to POST or PUT if a body is written to the request.

setRequestHeader

public void setRequestHeader(java.lang.String field,
                             java.lang.String value)

Sets the request header field to the given value.

Parameters:

field - the header field name.

value - the header field value.

setReadTimeout

public void setReadTimeout(int timeout)

Sets the read timeout in milliseconds. The read timeout is the number of milliseconds after the server receives a request and before the server sends data back.

Parameters:

timeout - the read timeout.

setConnectTimeout

public void setConnectTimeout(int timeout)

Sets the connect timeout in milliseconds.

Parameters:

timeout - the connect timeout in milliseconds.

writeOutput

public void writeOutput(byte[] body)

Saves the body to be sent with the request.

Parameters:

body - the request body.

readInput

public byte[] readInput()
                 throws TransportException

Reads from the input stream (response stream) and returns the response.

Returns:

the response body.

Throws:

TransportException - if the input stream could not be accessed, for example if the server could not be reached.

readError

public byte[] readError()
                 throws TransportException

Reads from the error stream and returns the error reason.

Returns:

the error reason.

Throws:

TransportException - if the input stream could not be accessed, for example if the server could not be reached.

getResponseStatus

public int getResponseStatus()
                      throws TransportException

Returns the response status code.

Returns:

the response status code.

Throws:

TransportException - if no response was received.

getResponseHeaders

public java.util.Map<java.lang.String,java.util.List<java.lang.String>> getResponseHeaders()

Returns the response headers as a Map, where the key is the header field name and the values are the values associated with the header field name.

Returns:

the response headers.