TwinState Class

Package:

com.microsoft.azure.sdk.iot.provisioning.service.configs

Maven Artifact:

com.microsoft.azure.sdk.iot.provisioning:provisioning-service-client:1.7.0

• java.lang.Object
• • com.microsoft.azure.sdk.iot.provisioning.service.configs.TwinState

public class TwinState

Representation of a single Twin initial state for the Device Provisioning Service.

The TwinState can contain one TwinCollection of Tags, and one TwinCollection of properties.desired.

Each entity in the collections can contain a associated TwinMetadata.

These metadata are provided by the Service and contains information about the last updated date time, and version.

For instance, the following is a valid TwinState, represented as initialTwin in the rest API.

{
          "initialTwin": {
              "tags":{
                  "SpeedUnity":"MPH",
                  "$metadata":{
                      "$lastUpdated":"2017-09-21T02:07:44.238Z",
                      "$lastUpdatedVersion":4,
                      "SpeedUnity":{
                          "$lastUpdated":"2017-09-21T02:07:44.238Z",
                          "$lastUpdatedVersion":4
                      }
                  },
                  "$version":4
              }
              "properties":{
                  "desired": {
                      "MaxSpeed":{
                          "Value":500,
                          "NewValue":300
                      },
                      "$metadata":{
                          "$lastUpdated":"2017-09-21T02:07:44.238Z",
                          "$lastUpdatedVersion":4,
                          "MaxSpeed":{
                              "$lastUpdated":"2017-09-21T02:07:44.238Z",
                              "$lastUpdatedVersion":4,
                              "Value":{
                                  "$lastUpdated":"2017-09-21T02:07:44.238Z",
                                  "$lastUpdatedVersion":4
                              },
                              "NewValue":{
                                  "$lastUpdated":"2017-09-21T02:07:44.238Z",
                                  "$lastUpdatedVersion":4
                              }
                          }
                      },
                      "$version":4
                  }
              }
          }
      }

Constructor Summary

Constructor	Description
TwinState(TwinCollection tags, TwinCollection desiredProperty)	CONSTRUCTOR

Method Summary

Modifier and Type	Method and Description
TwinCollection	getDesiredProperty() Getter for the desired property.
TwinCollection	getTags() Getter for the tags.
java.lang.String	toString() Creates a pretty print JSON with the content of this class and subclasses.

Methods inherited from java.lang.Object

java.lang.Object.clone java.lang.Object.equals java.lang.Object.finalize java.lang.Object.getClass java.lang.Object.hashCode java.lang.Object.notify java.lang.Object.notifyAll java.lang.Object.toString java.lang.Object.wait java.lang.Object.wait java.lang.Object.wait

Constructor Details

TwinState

public TwinState(TwinCollection tags, TwinCollection desiredProperty)

CONSTRUCTOR

This constructor creates an instance of the TwinState with the provided TwinCollection tags and desired properties.

When serialized, this class will looks like the following example:

"initialTwin": {
              "tags":{
                  "SpeedUnity":"MPH",
                  "$version":4
              }
              "properties":{
                  "desired":{
                      "MaxSpeed":{
                          "Value":500,
                          "NewValue":300
                      },
                      "$version":4
                  }
              }
          }
      
     }

Parameters:

tags - the TwinCollection with the initial tags state. It can be null.

desiredProperty - the TwinCollection with the initial desired properties. It can be null.

Method Details

getDesiredProperty

public TwinCollection getDesiredProperty()

Getter for the desired property.

Returns:

The TwinCollection with the desired property content. It can be null.

getTags

public TwinCollection getTags()

Getter for the tags.

Returns:

The TwinCollection with the tags content. It can be null.

toString

public String toString()

Creates a pretty print JSON with the content of this class and subclasses.

Overrides:

TwinState.toString()

Returns:

The String with the pretty print JSON.