[fix] ID field usage in string representation of EasyPost objects (#311)

- Fix ID field usage in string representation of EasyPost objects
- Add tests to verify string representation and pretty print of objects

Author: nwithan8

CHANGELOG.md

@@ -2,8 +2,9 @@
 
 ## Next Release
 
-- Fix payment method funding and deletion failures due to undetermined payment method type
 - Adds `refund` function in Insurance service for requesting a refund for a standalone insurance
+- Fix payment method funding and deletion failures due to undetermined payment method type
+- Fix `toString` method for all EasyPost models
 
 ## v7.1.1 (2024-03-21)
 

src/main/java/com/easypost/model/EasyPostResource.java

@@ -8,8 +8,6 @@
 
 package com.easypost.model;
 
-import java.lang.reflect.Field;
-
 import java.util.Date;
 
 import com.easypost.Constants;
@@ -30,27 +28,10 @@ public abstract class EasyPostResource {
      */
     @Override
     public String toString() {
-        return (String) this.getIdString();
-    }
-
-    /**
-     * Get the ID of the object.
-     *
-     * @return ID of the object.
-     */
-    private Object getIdString() {
-        try {
-            Field idField = this.getClass().getDeclaredField("id");
-            return idField.get(this);
-        } catch (SecurityException e) {
-            return "";
-        } catch (NoSuchFieldException e) {
-            return "";
-        } catch (IllegalArgumentException e) {
-            return "";
-        } catch (IllegalAccessException e) {
-            return "";
+        if (this.id == null) {
+            return String.format("<%s@%s>", this.getClass().getName(), System.identityHashCode(this));
         }
+        return String.format("<%s@%s id=%s>", this.getClass().getName(), System.identityHashCode(this), this.id);
     }
 
     /**
@@ -59,8 +40,9 @@ private Object getIdString() {
      * @return the JSON representation of the object.
      */
     public String prettyPrint() {
-        return String.format("<%s@%s id=%s> JSON: %s", this.getClass().getName(), System.identityHashCode(this),
-                this.getIdString(), Constants.Http.PRETTY_PRINT_GSON.toJson(this));
+        String identifier = this.toString();
+        String json = Constants.Http.PRETTY_PRINT_GSON.toJson(this);
+        return String.format("%s JSON: %s", identifier, json);
     }
 
     /**

src/test/cassettes/easypost_resource/pretty_print.json

@@ -0,0 +1,99 @@
+package com.easypost;
+
+import com.easypost.exception.EasyPostException;
+import com.easypost.model.Address;
+import com.google.common.collect.ImmutableList;
+import org.junit.jupiter.api.BeforeAll;
+import org.junit.jupiter.api.Test;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+public final class EasyPostResourceTest {
+    private static TestUtils.VCR vcr;
+
+    /**
+     * Set up the testing environment for this file.
+     *
+     * @throws EasyPostException when the request fails.
+     */
+    @BeforeAll
+    public static void setup() throws EasyPostException {
+        vcr = new TestUtils.VCR("easypost_resource", TestUtils.ApiKey.TEST);
+    }
+
+    /**
+     * Test string representation of an EasyPostResource.
+     *
+     * @throws EasyPostException when the request fails.
+     */
+    @Test
+    public void testToString() throws EasyPostException {
+        vcr.setUpTest("to_string");
+
+        Address address = vcr.client.address.create(Fixtures.caAddress1());
+
+        String stringRepresentation = address.toString();
+        List<String> substringsToContain = new ArrayList<String>(ImmutableList.of(
+                "<",
+                address.getClass().getName(),
+                "@",
+                "" + System.identityHashCode(address), // cast to string
+                " id=",
+                address.getId(),
+                ">"
+        ));
+
+        // Regex matching doesn't work in run mode, only in debug mode (timing issue?)
+        boolean matches = false;
+
+        for (String substring : substringsToContain) {
+            matches = stringRepresentation.contains(substring);
+            if (!matches) {
+                break;
+            }
+        }
+
+        assertTrue(matches);
+    }
+
+    /**
+     * Test pretty print of an EasyPostResource.
+     *
+     * @throws EasyPostException when the request fails.
+     */
+    @Test
+    public void testPrettyPrint() throws EasyPostException {
+        vcr.setUpTest("pretty_print");
+
+        Address address = vcr.client.address.create(Fixtures.caAddress1());
+
+        String prettyPrint = address.prettyPrint();
+
+        List<String> substringsToContain = new ArrayList<String>(ImmutableList.of(
+            "<",
+            address.getClass().getName(),
+            "@",
+            "" + System.identityHashCode(address), // cast to string
+            " id=",
+            address.getId(),
+            ">",
+            " JSON: {",
+            "}"
+        ));
+
+        // Regex matching doesn't work in run mode, only in debug mode (timing issue?)
+        boolean matches = false;
+
+        for (String substring : substringsToContain) {
+            matches = prettyPrint.contains(substring);
+            if (!matches) {
+                break;
+            }
+        }
+
+        assertTrue(matches);
+    }
+}