com.microsoft.azure.sdk.iot.service.devicetwin

Class DeviceOperations

java.lang.Object

com.microsoft.azure.sdk.iot.service.devicetwin.DeviceOperations

public class DeviceOperations
extends Object

Set of common operations for Twin and Method.

Constructor Summary

Constructors

Constructor and Description
DeviceOperations()

Method Summary

Modifier and Type	Method and Description
static HttpResponse	request(IotHubConnectionString iotHubConnectionString, URL url, HttpMethod method, byte[] payload, String requestId, long timeoutInMs) Send a http request to the IoTHub using the Twin/Method standard, and return its response.
static void	setHeaders(Map<String,String> httpHeaders) Sets headers to be used on next HTTP request

Methods inherited from class java.lang.Object

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

Constructor Detail

DeviceOperations

public DeviceOperations()

Method Detail

request

public static HttpResponse request(IotHubConnectionString iotHubConnectionString,
                                   URL url,
                                   HttpMethod method,
                                   byte[] payload,
                                   String requestId,
                                   long timeoutInMs)
                            throws IOException,
                                   IotHubException,
                                   IllegalArgumentException

Send a http request to the IoTHub using the Twin/Method standard, and return its response.

Parameters:

iotHubConnectionString - is the connection string for the IoTHub

url - is the Twin URL for the device ID.

method - is the HTTP method (GET, POST, DELETE, PATCH, PUT).

payload - is the array of bytes that contains the payload.

requestId - is an unique number that identify the request.

timeoutInMs - is timeout in milliseconds.

Returns:

the result of the request.

Throws:

IotHubException - This exception is thrown if the response verification failed

IOException - This exception is thrown if the IO operation failed

IllegalArgumentException

setHeaders

public static void setHeaders(Map<String,String> httpHeaders)
                       throws IllegalArgumentException

Sets headers to be used on next HTTP request

Parameters:

httpHeaders - non null and non empty custom headers

Throws:

IllegalArgumentException - This exception is thrown if headers were null or empty