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

Class IotHubUri

java.lang.Object

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

public final class IotHubUri
extends java.lang.Object

A URI for a device to connect to an IoT Hub.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	API_VERSION The API version will be passed as a param in the URI.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	IotHubUri()
	IotHubUri(java.lang.String iotHubHostname, java.lang.String deviceId, java.lang.String iotHubMethodPath, java.util.Map<java.lang.String,java.lang.String> queryParams, java.lang.String moduleId) Constructor.
	IotHubUri(java.lang.String iotHubHostname, java.lang.String deviceId, java.lang.String iotHubMethodPath, java.lang.String moduleId) Constructor.

Method Summary

Modifier and Type	Method and Description
static java.lang.String	getApiVersionString()
java.lang.String	getHostname() Returns the string representation of the IoT Hub hostname.
java.lang.String	getPath() Returns the string representation of the IoT Hub path.
static java.lang.String	getResourceUri(java.lang.String iotHubHostname, java.lang.String deviceId, java.lang.String moduleId) Returns the string representation of the IoT Hub resource URI.
java.lang.String	toString() Returns the string representation of the IoT Hub URI.
java.lang.String	toStringWithoutApiVersion()

Methods inherited from class java.lang.Object

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

Field Detail

API_VERSION

public static final java.lang.String API_VERSION

The API version will be passed as a param in the URI.

See Also:

Constant Field Values

Constructor Detail

IotHubUri

public IotHubUri(java.lang.String iotHubHostname,
                 java.lang.String deviceId,
                 java.lang.String iotHubMethodPath,
                 java.util.Map<java.lang.String,java.lang.String> queryParams,
                 java.lang.String moduleId)

Constructor. Creates a URI to an IoT Hub method. The URI does not include a protocol. The function will safely escape the given arguments.

Parameters:

iotHubHostname - the IoT Hub hostname.

deviceId - the device ID.

iotHubMethodPath - the path from the IoT Hub resource to the method.

queryParams - the URL query parameters. Can be null.

moduleId - the module ID. May be null

IotHubUri

public IotHubUri(java.lang.String iotHubHostname,
                 java.lang.String deviceId,
                 java.lang.String iotHubMethodPath,
                 java.lang.String moduleId)

Constructor. Equivalent to new IotHubUri(iotHubHostname, deviceId, iotHubMethodPath, null).

Parameters:

iotHubHostname - the IoT Hub hostname.

deviceId - the device ID.

iotHubMethodPath - the path from the IoT Hub resource to the method.

moduleId - the module ID.

IotHubUri

protected IotHubUri()

Method Detail

toString

public java.lang.String toString()

Returns the string representation of the IoT Hub URI.

Overrides:

toString in class java.lang.Object

Returns:

the string representation of the IoT Hub URI.

toStringWithoutApiVersion

public java.lang.String toStringWithoutApiVersion()

getHostname

public java.lang.String getHostname()

Returns the string representation of the IoT Hub hostname.

Returns:

the string representation of the IoT Hub hostname.

getPath

public java.lang.String getPath()

Returns the string representation of the IoT Hub path.

Returns:

the string representation of the IoT Hub path.

getResourceUri

public static java.lang.String getResourceUri(java.lang.String iotHubHostname,
                                              java.lang.String deviceId,
                                              java.lang.String moduleId)

Returns the string representation of the IoT Hub resource URI. The IoT Hub resource URI is the hostname and path component that is common to all IoT Hub communication methods between the given device and IoT Hub. Safely escapes the IoT Hub resource URI.

Parameters:

iotHubHostname - the IoT Hub hostname.

deviceId - the device ID.

moduleId - the module ID.

Returns:

the string representation of the IoT Hub resource URI.

getApiVersionString

public static java.lang.String getApiVersionString()