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

Class DeviceTwinDevice

java.lang.Object

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

public class DeviceTwinDevice
extends Object

Constructor Summary

Constructors

Constructor and Description
DeviceTwinDevice() Constructor to create instance for a device
DeviceTwinDevice(String deviceId) Constructor to create instance for a device

Method Summary

Modifier and Type	Method and Description
void	clearDesiredProperties() Clear desired properties set so far
void	clearTags()
void	clearTwin() Clear tags and desired properties set so far
String	desiredPropertiesToString() String representation for this device containing desired properties
protected Map<String,Object>	getDesiredMap() Getter for the desired properties
Set<Pair>	getDesiredProperties() Getter to get Desired Properties set
String	getDeviceId() Getter to get device ID
String	getETag() Getter for the eTag
protected Map<String,Object>	getReportedMap() Getter for the reported properties
Set<Pair>	getReportedProperties() Getter to get Reported Properties Set
Set<Pair>	getTags() Getter to get Tags Set
protected Map<String,Object>	getTagsMap() Getter for the tags
protected com.microsoft.azure.sdk.iot.deps.serializer.TwinParser	getTwinParser() Getter for the twin serializer object for this device
Integer	getVersion() Getter for the Twin version
String	reportedPropertiesToString() String representation for this device containing reported properties
protected void	setDesiredProperties(Map<String,Object> desiredProperties) Setter for the desired properties
void	setDesiredProperties(Set<Pair> desiredProperties) Setter for the desired properties
void	setETag(String eTag) Setter for ETag
protected void	setReportedProperties(Map<String,Object> reportedProperties) Setter for the reported properties
protected void	setTags(Map<String,Object> tag) Setter for the tags
void	setTags(Set<Pair> tags) Setter for the tags
String	tagsToString() String representation for this device containing tags
String	toString() String representation for this device containing device id, tags, desired and reported properties

Methods inherited from class java.lang.Object

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

Constructor Detail

DeviceTwinDevice

public DeviceTwinDevice()

Constructor to create instance for a device

DeviceTwinDevice

public DeviceTwinDevice(String deviceId)
                 throws IllegalArgumentException

Constructor to create instance for a device

Parameters:

deviceId - Device ID for this device

Throws:

IllegalArgumentException - This exception is thrown if the device id is null or empty

Method Detail

getDeviceId

public String getDeviceId()

Getter to get device ID

Returns:

device id for this device

setETag

public void setETag(String eTag)
             throws IllegalArgumentException

Setter for ETag

Parameters:

eTag - is the value of the etag

Throws:

IllegalArgumentException - if the provided etag is null or empty

getETag

public String getETag()

Getter for the eTag

Returns:

the stored eTag. It will be null if not set.

getVersion

public Integer getVersion()

Getter for the Twin version

Returns:

the stored version. It can be null.

setTags

public void setTags(Set<Pair> tags)
             throws IllegalArgumentException

Setter for the tags

Parameters:

tags - A set of tag key-value pairs

Throws:

IllegalArgumentException - This exception is thrown if the set tags is null

getTags

public Set<Pair> getTags()

Getter to get Tags Set

Returns:

A set of tag key value pairs.

clearTags

public void clearTags()

getDesiredProperties

public Set<Pair> getDesiredProperties()

Getter to get Desired Properties set

Returns:

A set of desired property pairs.

setDesiredProperties

public void setDesiredProperties(Set<Pair> desiredProperties)
                          throws IllegalArgumentException

Setter for the desired properties

Parameters:

desiredProperties - A set of key-value pairs for desired properties

Throws:

IllegalArgumentException - This exception is thrown if the set is null

clearDesiredProperties

public void clearDesiredProperties()

Clear desired properties set so far

clearTwin

public void clearTwin()

Clear tags and desired properties set so far

getReportedProperties

public Set<Pair> getReportedProperties()

Getter to get Reported Properties Set

Returns:

A set of reported property pairs.

setReportedProperties

protected void setReportedProperties(Map<String,Object> reportedProperties)

Setter for the reported properties

Parameters:

reportedProperties - A map of validated key and value pairs for reported properties

setDesiredProperties

protected void setDesiredProperties(Map<String,Object> desiredProperties)

Setter for the desired properties

Parameters:

desiredProperties - A map of validated key and value pairs for desired properties

setTags

protected void setTags(Map<String,Object> tag)

Setter for the tags

Parameters:

tag - A map of validated key and value pairs for tag

getTagsMap

protected Map<String,Object> getTagsMap()

Getter for the tags

Returns:

A map of validated key and value pairs for tag

getDesiredMap

protected Map<String,Object> getDesiredMap()

Getter for the desired properties

Returns:

A map of validated key and value pairs for desired properties

getReportedMap

protected Map<String,Object> getReportedMap()

Getter for the reported properties

Returns:

A map of validated key and value pairs for reported properties

getTwinParser

protected com.microsoft.azure.sdk.iot.deps.serializer.TwinParser getTwinParser()

Getter for the twin serializer object for this device

Returns:

An object for twin serializer for this device

toString

public String toString()

String representation for this device containing device id, tags, desired and reported properties

Overrides:

toString in class Object

Returns:

String representation for this device

tagsToString

public String tagsToString()

String representation for this device containing tags

Returns:

String representation for this device tags

desiredPropertiesToString

public String desiredPropertiesToString()

String representation for this device containing desired properties

Returns:

String representation for this device desired properties

reportedPropertiesToString

public String reportedPropertiesToString()

String representation for this device containing reported properties

Returns:

String representation for this device reported properties