Update documentation for generated models (#318)

Update the documentation for all the generated models.

Author: TwistedTwigleg

sdk/src/main/java/software/amazon/awssdk/iot/iotidentity/IotIdentityClient.java

@@ -46,6 +46,10 @@ public class IotIdentityClient {
     private MqttClientConnection connection = null;
     private final Gson gson = getGson();
 
+    /**
+     * Constructs a new IotIdentityClient
+     * @param connection The connection to use
+     */
     public IotIdentityClient(MqttClientConnection connection) {
         this.connection = connection;
     }

sdk/src/main/java/software/amazon/awssdk/iot/iotjobs/IotJobsClient.java

@@ -59,6 +59,10 @@ public class IotJobsClient {
     private MqttClientConnection connection = null;
     private final Gson gson = getGson();
 
+    /**
+     * Constructs a new IotJobsClient
+     * @param connection The connection to use
+     */
     public IotJobsClient(MqttClientConnection connection) {
         this.connection = connection;
     }
@@ -282,7 +286,6 @@ public CompletableFuture<Integer> SubscribeToDescribeJobExecutionRejected(
     }
 
     /**
-     * 
      *
      * Once subscribed, `handler` is invoked each time a message matching
      * the `topic` is received. It is possible for such messages to arrive before
@@ -325,7 +328,6 @@ public CompletableFuture<Integer> SubscribeToNextJobExecutionChangedEvents(
     }
 
     /**
-     * 
      *
      * Once subscribed, `handler` is invoked each time a message matching
      * the `topic` is received. It is possible for such messages to arrive before

sdk/src/main/java/software/amazon/awssdk/iot/iotjobs/model/JobStatus.java

@@ -13,22 +13,49 @@
  */
 public enum JobStatus {
 
+    /**
+     * Enum value is an unknown value
+     */
     UNKNOWN_ENUM_VALUE("UNKNOWN_ENUM_VALUE"),
 
+    /**
+     * Enum value for IN_PROGRESS
+     */
     IN_PROGRESS("IN_PROGRESS"),
 
+    /**
+     * Enum value for FAILED
+     */
     FAILED("FAILED"),
 
+    /**
+     * Enum value for QUEUED
+     */
     QUEUED("QUEUED"),
 
+    /**
+     * Enum value for TIMED_OUT
+     */
     TIMED_OUT("TIMED_OUT"),
 
+    /**
+     * Enum value for SUCCEEDED
+     */
     SUCCEEDED("SUCCEEDED"),
 
+    /**
+     * Enum value for CANCELED
+     */
     CANCELED("CANCELED"),
 
+    /**
+     * Enum value for REJECTED
+     */
     REJECTED("REJECTED"),
 
+    /**
+     * Enum value for REMOVED
+     */
     REMOVED("REMOVED");
 
     private String value;
@@ -42,6 +69,12 @@ public String toString() {
         return value;
     }
 
+    /**
+     * Returns The enum associated with the given string or UNKNOWN_ENUM_VALUE
+     * if no enum is found.
+     * @param val The string to use
+     * @return The enum associated with the string or UNKNOWN_ENUM_VALUE
+     */
     static JobStatus fromString(String val) {
         for (JobStatus e : JobStatus.class.getEnumConstants()) {
             if (e.toString().compareTo(val) == 0) {

sdk/src/main/java/software/amazon/awssdk/iot/iotjobs/model/RejectedErrorCode.java

@@ -13,6 +13,9 @@
  */
 public enum RejectedErrorCode {
 
+    /**
+     * Enum value is an unknown value
+     */
     UNKNOWN_ENUM_VALUE("UNKNOWN_ENUM_VALUE"),
 
     /**
@@ -71,6 +74,12 @@ public String toString() {
         return value;
     }
 
+    /**
+     * Returns The enum associated with the given string or UNKNOWN_ENUM_VALUE
+     * if no enum is found.
+     * @param val The string to use
+     * @return The enum associated with the string or UNKNOWN_ENUM_VALUE
+     */
     static RejectedErrorCode fromString(String val) {
         for (RejectedErrorCode e : RejectedErrorCode.class.getEnumConstants()) {
             if (e.toString().compareTo(val) == 0) {

sdk/src/main/java/software/amazon/awssdk/iot/iotshadow/IotShadowClient.java

@@ -65,6 +65,10 @@ public class IotShadowClient {
     private MqttClientConnection connection = null;
     private final Gson gson = getGson();
 
+    /**
+     * Constructs a new IotShadowClient
+     * @param connection The connection to use
+     */
     public IotShadowClient(MqttClientConnection connection) {
         this.connection = connection;
     }

sdk/src/main/java/software/amazon/awssdk/iot/iotshadow/model/ShadowState.java

@@ -21,6 +21,9 @@ public class ShadowState {
      */
     public HashMap<String, Object> desired;
 
+    /**
+     * If set to true, then desired can be set to null.
+     */
     public transient boolean desiredIsNullable;
 
     /**
@@ -29,6 +32,9 @@ public class ShadowState {
      */
     public HashMap<String, Object> reported;
 
+    /**
+     * If set to true, then reported can be set to null.
+     */
     public transient boolean reportedIsNullable;
 
 }