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

Class HttpsTransportManager

java.lang.Object

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

public class HttpsTransportManager
extends java.lang.Object

Implementation of the transport manager for https.

Constructor Summary

Constructors

Constructor and Description
HttpsTransportManager(ClientConfiguration config) Constructor

Method Summary

Modifier and Type	Method and Description
HttpsResponse	getFileUploadSasUri(IotHubTransportMessage message)
DirectMethodResponse	invokeMethod(DirectMethodRequest directMethodRequest, java.lang.String deviceId, java.lang.String moduleId) Invoke a direct method to the provided uri
Message	receive() Pull the IotHub looking for new message.
HttpsResponse	send(IotHubTransportMessage message, java.util.Map<java.lang.String,java.lang.String> additionalHeaders) This is a blocking send message.
HttpsResponse	sendFileUploadNotification(IotHubTransportMessage message)

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpsTransportManager

public HttpsTransportManager(ClientConfiguration config)
                      throws java.lang.IllegalArgumentException

Constructor

Parameters:

config - is the set of device configurations.

Throws:

java.lang.IllegalArgumentException - is the config is null.

Method Detail

getFileUploadSasUri

public HttpsResponse getFileUploadSasUri(IotHubTransportMessage message)
                                  throws java.io.IOException

Throws:

java.io.IOException

sendFileUploadNotification

public HttpsResponse sendFileUploadNotification(IotHubTransportMessage message)
                                         throws java.io.IOException

Throws:

java.io.IOException

send

public HttpsResponse send(IotHubTransportMessage message,
                          java.util.Map<java.lang.String,java.lang.String> additionalHeaders)
                   throws java.io.IOException,
                          java.lang.IllegalArgumentException

This is a blocking send message. It send the provide message, wait for the IotHub answer, and return is in the ResponseMessage, which contains the status and the payload.

Parameters:

message - is the message to send.

additionalHeaders - the http headers to use in the request.

Returns:

the IotHub response with the status and payload.

Throws:

java.io.IOException - if the IotHub communication failed.

java.lang.IllegalArgumentException - if the provided message is null, or invalid.

receive

public Message receive()
                throws java.io.IOException

Pull the IotHub looking for new message.

Returns:

New message from the IotHub. It can be null is there is no new message to read.

Throws:

java.io.IOException - if the IotHub communication failed.

invokeMethod

public DirectMethodResponse invokeMethod(DirectMethodRequest directMethodRequest,
                                         java.lang.String deviceId,
                                         java.lang.String moduleId)
                                  throws java.io.IOException,
                                         TransportException

Invoke a direct method to the provided uri

Parameters:

directMethodRequest - the method request to make

deviceId - the device id of the device the moduleId belongs to

moduleId - the module id of the module to invoke the method on

Returns:

the result of that request

Throws:

java.io.IOException - if the IotHub cannot be reached

TransportException - if any issues occur when sending the http request to its target