feat: add de-serialization logic for JSON arrays within response body

Author: padamstx

src/main/java/com/ibm/cloud/sdk/core/util/ResponseConverterUtils.java

@@ -65,8 +65,7 @@ public InputStream convert(Response response) {
   }
 
   /**
-   * Creates a generic {@link ResponseConverter} for a POJO class. <br>
-   * It should extend {@link ObjectModel}
+   * Creates a generic {@link ResponseConverter} for a POJO class that extends ObjectModel.
    *
    * @param <T> the generic type
    * @param type the type
@@ -81,6 +80,17 @@ public T convert(Response response) {
     };
   }
 
+  /**
+   * Creates a generic {@link ResponseConverter} for a POJO class.
+   *
+   * @param <T> the generic type
+   * @param type a Type instance that describes the type
+   * @return the response converter
+   */
+  public static <T> ResponseConverter<T> getObject(final Type type) {
+    return getValue(type);
+  }
+
   /**
    * Creates a generic {@link ResponseConverter} for a String response.
    *
@@ -111,6 +121,23 @@ public T convert(Response response) {
     };
   }
 
+  /**
+   * Creates a generic {@link ResponseConverter} for a response with a Type
+   * instance that describes the type.
+   * @param <T> the generic type
+   * @param type the type
+   *
+   * @return the response converter
+   */
+  public static <T> ResponseConverter<T> getValue(final Type type) {
+    return new ResponseConverter<T>() {
+      @Override
+      public T convert(Response response) {
+        return ResponseUtils.getValue(response, type);
+      }
+    };
+  }
+
   /**
    * Gets the void converter.
    * @return the void converter

src/main/java/com/ibm/cloud/sdk/core/util/ResponseUtils.java

@@ -14,6 +14,7 @@
 
 import java.io.IOException;
 import java.io.InputStream;
+import java.lang.reflect.Type;
 import java.util.logging.Level;
 import java.util.logging.Logger;
 
@@ -96,6 +97,24 @@ public static <T extends ObjectModel> T getObject(Response response, Class<? ext
     }
   }
 
+
+  /**
+   * Parses the {@link Response} into the POJO representation.
+   *
+   * @param <T> the generic type to use when parsing the response
+   * @param response the HTTP response
+   * @param type a Type instance which describes the type of the response
+   * @return the POJO
+   */
+  public static <T> T getObject(Response response, Type type) {
+    JsonReader reader;
+    try {
+      reader = new JsonReader(response.body().charStream());
+      return GsonSingleton.getGsonWithoutPrettyPrinting().fromJson(reader, type);
+    } finally {
+      response.body().close();
+    }
+  }
   /**
    * Parses the {@link Response} into a value of the specified type.
    *
@@ -114,6 +133,24 @@ public static <T> T getValue(Response response, Class<? extends T> valueType) {
     }
   }
 
+  /**
+   * Parses the {@link Response} into a value of the specified type.
+   *
+   * @param <T> the generic type to use when parsing the response
+   * @param response the HTTP response
+   * @param valueType a Type instance which describes the type associated with the response
+   * @return the value
+   */
+  public static <T> T getValue(Response response, Type valueType) {
+    JsonReader reader;
+    try {
+      reader = new JsonReader(response.body().charStream());
+      return GsonSingleton.getGsonWithoutPrettyPrinting().fromJson(reader, valueType);
+    } finally {
+      response.body().close();
+    }
+  }
+
   /**
    * Returns a String representation of the response.
    *