Move End Shipper to general availability (#178)

* - Copy EndShipper class to main namespace
- Mark EndShipper beta class as deprecated
- Update EndShipper.all to return EndShipperCollection
- New EndShipperCollection class to wrap list of End Shipper objects
- Update unit tests
- Fix bad docstrings

Author: nwithan8

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

@@ -11,7 +11,7 @@ public final class AddressCollection extends EasyPostResource {
     /**
      * Get a list of addresses.
      *
-     * @return List of Batch objects
+     * @return List of Address objects
      */
     public List<Address> getAddresses() {
         return addresses;
@@ -20,7 +20,7 @@ public List<Address> getAddresses() {
     /**
      * Set a list of addresses.
      *
-     * @param addresses List of Batch objects
+     * @param addresses List of Address objects
      */
     public void setAddresses(final List<Address> addresses) {
         this.addresses = addresses;

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

@@ -0,0 +1,117 @@
+package com.easypost.model;
+
+import com.easypost.EasyPost;
+import com.easypost.exception.EasyPostException;
+
+import java.util.HashMap;
+import java.util.Map;
+
+public final class EndShipper extends BaseAddress {
+    /**
+     * Create EndShipper object from parameter map.
+     *
+     * @param params Map of EndShipper parameters.
+     * @return EndShipper object.
+     * @throws EasyPostException when the request fails.
+     */
+    public static EndShipper create(final Map<String, Object> params) throws EasyPostException {
+        return create(params, null);
+    }
+
+    /**
+     * Create EndShipper object from parameter map.
+     *
+     * @param params Map of EndShipper parameters.
+     * @param apiKey Optional API key to use for this request.
+     * @return EndShipper object.
+     * @throws EasyPostException when the request fails.
+     */
+    public static EndShipper create(final Map<String, Object> params, final String apiKey) throws EasyPostException {
+        Map<String, Object> wrappedParams = new HashMap<String, Object>();
+
+        wrappedParams.put("address", params);
+
+        return request(RequestMethod.POST, String.format("%s/%s", EasyPost.API_BASE, "end_shippers"),
+                wrappedParams, EndShipper.class, apiKey);
+    }
+
+    /**
+     * Retrieve EndShipper object from API.
+     *
+     * @param id ID of EndShipper to retrieve.
+     * @return EndShipper object.
+     * @throws EasyPostException when the request fails.
+     */
+    public static EndShipper retrieve(final String id) throws EasyPostException {
+        return retrieve(id, null);
+    }
+
+    /**
+     * Retrieve EndShipper object from API.
+     *
+     * @param id     ID of EndShipper to retrieve.
+     * @param apiKey API key to use in request (overrides default API key).
+     * @return EndShipper object.
+     * @throws EasyPostException when the request fails.
+     */
+    public static EndShipper retrieve(final String id, final String apiKey) throws EasyPostException {
+        return request(RequestMethod.GET, String.format("%s/%s/%s", EasyPost.API_BASE, "end_shippers", id), null,
+                EndShipper.class, apiKey);
+    }
+
+    /**
+     * List all EndShipper objects.
+     *
+     * @param params Map of parameters.
+     * @return EndShipperCollection object.
+     * @throws EasyPostException when the request fails.
+     */
+    public static EndShipperCollection all(final Map<String, Object> params) throws EasyPostException {
+        return all(params, null);
+    }
+
+    /**
+     * List all EndShipper objects.
+     *
+     * @param params Map of parameters.
+     * @param apiKey API key to use in request (overrides default API key).
+     * @return EndShipperCollection object.
+     * @throws EasyPostException when the request fails.
+     */
+    public static EndShipperCollection all(final Map<String, Object> params, final String apiKey)
+            throws EasyPostException {
+        return request(RequestMethod.GET, classURL(EndShipper.class), params, EndShipperCollection.class, apiKey);
+    }
+
+    /**
+     * Update an EndShipper object.
+     *
+     * @param params Map of parameters.
+     * @return EndShipper object.
+     * @throws EasyPostException when the request fails.
+     */
+    public EndShipper update(final Map<String, Object> params) throws EasyPostException {
+        return update(params, null);
+    }
+
+    /**
+     * Update an EndShipper object.
+     *
+     * @param params Map of parameters.
+     * @param apiKey API key to use in request (overrides default API key).
+     * @return EndShipper object.
+     * @throws EasyPostException when the request fails.
+     */
+    public EndShipper update(final Map<String, Object> params, final String apiKey) throws EasyPostException {
+        Map<String, Object> wrappedParams = new HashMap<String, Object>();
+
+        wrappedParams.put("address", params);
+
+        EndShipper response = request(RequestMethod.PUT,
+                String.format("%s/%s/%s", EasyPost.API_BASE, "end_shippers", this.getId()), wrappedParams,
+                EndShipper.class, apiKey);
+
+        this.merge(this, response);
+        return this;
+    }
+}

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

@@ -0,0 +1,44 @@
+package com.easypost.model;
+
+import java.util.List;
+
+public class EndShipperCollection {
+    private List<EndShipper> endShippers;
+    private Boolean hasMore;
+
+    /**
+     * Get a list of EndShippers.
+     *
+     * @return List of EndShipper objects
+     */
+    public List<EndShipper> getEndShippers() {
+        return endShippers;
+    }
+
+    /**
+     * Set a list of EndShippers.
+     *
+     * @param addresses List of EndShipper objects
+     */
+        public void setEndShippers(final List<EndShipper> addresses) {
+        this.endShippers = addresses;
+    }
+
+    /**
+     * Get whether there are more EndShippers to retrieve.
+     *
+     * @return whether there are more EndShippers to retrieve
+     */
+    public Boolean getHasMore() {
+        return hasMore;
+    }
+
+    /**
+     * Set whether there are more EndShippers to retrieve.
+     *
+     * @param hasMore Boolean whether there are more EndShippers to retrieve
+     */
+    public void setHasMore(final Boolean hasMore) {
+        this.hasMore = hasMore;
+    }
+}

src/main/java/com/easypost/model/beta/EndShipper.java

@@ -9,11 +9,15 @@
 import java.util.List;
 import java.util.Map;
 
+/**
+ * @deprecated Use {@link com.easypost.model.EndShipper} instead.
+ * Deprecated: v5.9.0 - v7.0.0
+ */
 public final class EndShipper extends BaseAddress {
     /**
      * Create EndShipper object from parameter map.
      *
-     * @param params Map of end shipper parameters.
+     * @param params Map of EndShipper parameters.
      * @return EndShipper object.
      * @throws EasyPostException when the request fails.
      */
@@ -24,7 +28,7 @@ public static EndShipper create(final Map<String, Object> params) throws EasyPos
     /**
      * Create EndShipper object from parameter map.
      *
-     * @param params Map of end shipper parameters.
+     * @param params Map of EndShipper parameters.
      * @param apiKey Optional API key to use for this request.
      * @return EndShipper object.
      * @throws EasyPostException when the request fails.
@@ -41,7 +45,7 @@ public static EndShipper create(final Map<String, Object> params, final String a
     /**
      * Retrieve EndShipper object from API.
      *
-     * @param id ID of end shipper to retrieve.
+     * @param id ID of EndShipper to retrieve.
      * @return EndShipper object.
      * @throws EasyPostException when the request fails.
      */
@@ -52,7 +56,7 @@ public static EndShipper retrieve(final String id) throws EasyPostException {
     /**
      * Retrieve EndShipper object from API.
      *
-     * @param id     ID of end shipper to retrieve.
+     * @param id     ID of EndShipper to retrieve.
      * @param apiKey API key to use in request (overrides default API key).
      * @return EndShipper object.
      * @throws EasyPostException when the request fails.