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

Class HttpsRequest

java.lang.Object

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

public class HttpsRequest
extends java.lang.Object

An HTTPS request.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	HttpsRequest()
	HttpsRequest(java.net.URL url, HttpsMethod method, byte[] body, java.lang.String userAgentString) Constructor.
	HttpsRequest(java.net.URL url, HttpsMethod method, byte[] body, java.lang.String userAgentString, ProxySettings proxySettings) Constructor.

Method Summary

Modifier and Type	Method and Description
byte[]	getBody()
java.lang.String	getHttpMethod()
java.lang.String	getRequestHeaders()
java.net.URL	getRequestUrl()
HttpsResponse	send() Executes the HTTPS request.
HttpsResponse	sendAsHttpRequest() Executes the HTTPS request as an HTTP request.
HttpsRequest	setConnectTimeout(int timeout) Sets the connect timeout, in milliseconds, for the request.
HttpsRequest	setHeaderField(java.lang.String field, java.lang.String value) Sets the header field to the given value.
HttpsRequest	setReadTimeout(int timeout) Sets the read timeout, in milliseconds, for the request.
HttpsRequest	setSSLContext(javax.net.ssl.SSLContext sslContext) Sets this object's SSL context

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpsRequest

public HttpsRequest(java.net.URL url,
                    HttpsMethod method,
                    byte[] body,
                    java.lang.String userAgentString)

Constructor. Takes a URL as an argument and returns an HTTPS request that is ready to be sent.

Parameters:

url - the URL for the request.

method - the HTTPS request method (i.e. GET).

body - the request body. Must be an array of size 0 if the request method is GET or DELETE.

userAgentString - the user agent string to attach to all http communications

HttpsRequest

public HttpsRequest(java.net.URL url,
                    HttpsMethod method,
                    byte[] body,
                    java.lang.String userAgentString,
                    ProxySettings proxySettings)

Constructor. Takes a URL as an argument and returns an HTTPS request that is ready to be sent.

Parameters:

url - the URL for the request.

method - the HTTPS request method (i.e. GET).

body - the request body. Must be an array of size 0 if the request method is GET or DELETE.

userAgentString - the user agent string to attach to all http communications

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

HttpsRequest

protected HttpsRequest()

Method Detail

send

public HttpsResponse send()
                   throws TransportException

Executes the HTTPS request.

Returns:

an HTTPS response.

Throws:

TransportException - if the connection could not be established, or the input/output streams could not be accessed.

sendAsHttpRequest

public HttpsResponse sendAsHttpRequest()
                                throws TransportException

Executes the HTTPS request as an HTTP request. This method should only be called when a user supplied url contains HTTP rather than HTTPS. Currently, this only happens from the HttpsHsmClient for some edge workload urls.

Returns:

an HTTPS response.

Throws:

TransportException - if the connection could not be established, or the input/output streams could not be accessed.

setHeaderField

public HttpsRequest setHeaderField(java.lang.String field,
                                   java.lang.String value)

Sets the header field to the given value.

Parameters:

field - the header field name.

value - the header field value.

Returns:

itself, for fluent setting.

setReadTimeout

public HttpsRequest setReadTimeout(int timeout)

Sets the read timeout, in milliseconds, for the request. 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.

Returns:

itself, for fluent setting.

setConnectTimeout

public HttpsRequest setConnectTimeout(int timeout)

Sets the connect timeout, in milliseconds, for the request.

Parameters:

timeout - the connect timeout in milliseconds.

Returns:

itself, for fluent setting.

setSSLContext

public HttpsRequest setSSLContext(javax.net.ssl.SSLContext sslContext)
                           throws java.lang.IllegalArgumentException

Sets this object's SSL context

Parameters:

sslContext - the value to set this object's SSL context too

Returns:

itself, for fluent setting.

Throws:

java.lang.IllegalArgumentException - if sslContext is null

getBody

public byte[] getBody()

getRequestUrl

public java.net.URL getRequestUrl()

getHttpMethod

public java.lang.String getHttpMethod()

getRequestHeaders

public java.lang.String getRequestHeaders()