Tidied up a little.

- (Mostly) automatically reformatted code using IntelliJ IDEA to match the Google Style Guide (as documented in CONTRIBUTING.md).
  - 2 space indent, where it wasn't already.
  - Line wrap at 100 characters, where it wasn't already.
  - Wildcard imports were replaced with explicit imports.
  - Unused imports were removed.
  - Annotations were put onto their own line, and additional lines added for readability where necessary.
  - Braces were added to if-statements that didn't already have them.
- Also made some minor edits, e.g. as suggested by IntelliJ IDEA (e.g. public --> private).

This will help with getting the code into shape before style conformance is required as per issue sendgrid#472 and pull request sendgrid#496.

See also:
- https://github.com/google/google-java-format
- https://plugins.jetbrains.com/plugin/8527-google-java-format
- https://github.com/google/styleguide/blob/gh-pages/intellij-java-google-style.xml

Author: RohanTalip

src/main/java/com/sendgrid/APICallback.java

@@ -1,19 +1,22 @@
 package com.sendgrid;
 
 /**
- * An interface describing a callback mechanism for the
- * asynchronous, rate limit aware API connection.
+ * An interface describing a callback mechanism for the asynchronous, rate limit aware API
+ * connection.
  */
 public interface APICallback {
-    /**
-     * Callback method in case of an error.
-     * @param ex the error that was thrown.
-     */
-    public void error(Exception ex);
 
-    /**
-     * Callback method in case of a valid response.
-     * @param response the valid response.
-     */
-    public void response(Response response);
+  /**
+   * Callback method in case of an error.
+   *
+   * @param ex the error that was thrown.
+   */
+  public void error(Exception ex);
+
+  /**
+   * Callback method in case of a valid response.
+   *
+   * @param response the valid response.
+   */
+  public void response(Response response);
 }

src/main/java/com/sendgrid/RateLimitException.java

@@ -1,36 +1,40 @@
 package com.sendgrid;
 
 /**
- * An exception thrown when the maximum number of retries
- * have occurred, and the API calls are still rate limited.
+ * An exception thrown when the maximum number of retries have occurred, and the API calls are still
+ * rate limited.
  */
 public class RateLimitException extends Exception {
-    private final Request request;
-    private final int retryCount;
 
-    /**
-     * Construct a new exception.
-     * @param request the originating request object.
-     * @param retryCount the number of times a retry was attempted.
-     */
-    public RateLimitException(Request request, int retryCount) {
-        this.request = request;
-        this.retryCount = retryCount;
-    }
+  private final Request request;
+  private final int retryCount;
 
-    /**
-     * Get the originating request object.
-     * @return the request object.
-     */
-    public Request getRequest() {
-        return this.request;
-    }
+  /**
+   * Construct a new exception.
+   *
+   * @param request the originating request object.
+   * @param retryCount the number of times a retry was attempted.
+   */
+  public RateLimitException(Request request, int retryCount) {
+    this.request = request;
+    this.retryCount = retryCount;
+  }
 
-    /**
-     * Get the number of times the action was attemted.
-     * @return the retry count.
-     */
-    public int getRetryCount() {
-        return this.retryCount;
-    }
+  /**
+   * Get the originating request object.
+   *
+   * @return the request object.
+   */
+  public Request getRequest() {
+    return this.request;
+  }
+
+  /**
+   * Get the number of times the action was attemted.
+   *
+   * @return the retry count.
+   */
+  public int getRetryCount() {
+    return this.retryCount;
+  }
 }

src/main/java/com/sendgrid/SendGrid.java

@@ -3,12 +3,12 @@
 import java.io.IOException;
 import java.util.HashMap;
 import java.util.Map;
-import java.util.concurrent.Executors;
 import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
 
 /**
-  * Class SendGrid allows for quick and easy access to the SendGrid API.
-  */
+ * The SendGrid class allows for quick and easy access to the SendGrid API.
+ */
 public class SendGrid implements SendGridAPI {
 
   private static final String VERSION = "3.0.0";
@@ -43,6 +43,7 @@ public class SendGrid implements SendGridAPI {
 
   /**
    * Construct a new SendGrid API wrapper.
+   *
    * @param apiKey is your SendGrid API Key: https://app.sendgrid.com/settings/api_keys
    */
   public SendGrid(String apiKey) {
@@ -52,6 +53,7 @@ public SendGrid(String apiKey) {
 
   /**
    * Construct a new SendGrid API wrapper.
+   *
    * @param apiKey is your SendGrid API Key: https://app.sendgrid.com/settings/api_keys
    * @param test is true if you are unit testing
    */
@@ -62,6 +64,7 @@ public SendGrid(String apiKey, Boolean test) {
 
   /**
    * Construct a new SendGrid API wrapper.
+   *
    * @param apiKey is your SendGrid API Key: https://app.sendgrid.com/settings/api_keys
    * @param client the Client to use (allows to customize its configuration)
    */
@@ -72,6 +75,7 @@ public SendGrid(String apiKey, Client client) {
 
   /**
    * Initialize the client.
+   *
    * @param apiKey the user's API key.
    */
   public void initializeSendGrid(String apiKey) {
@@ -90,14 +94,16 @@ public void initializeSendGrid(String apiKey) {
 
   /**
    * Retrieve the current library version.
+   *
    * @return the current version.
    */
   public String getLibraryVersion() {
-    return this.VERSION;
+    return VERSION;
   }
 
   /**
    * Get the API version.
+   *
    * @return the current API versioin (v3 by default).
    */
   public String getVersion() {
@@ -106,6 +112,7 @@ public String getVersion() {
 
   /**
    * Set the API version.
+   *
    * @param version the new version.
    */
   public void setVersion(String version) {
@@ -114,6 +121,7 @@ public void setVersion(String version) {
 
   /**
    * Obtain the request headers.
+   *
    * @return the request headers.
    */
   public Map<String, String> getRequestHeaders() {
@@ -122,6 +130,7 @@ public Map<String, String> getRequestHeaders() {
 
   /**
    * Add a new request header.
+   *
    * @param key the header key.
    * @param value the header value.
    * @return the new set of request headers.
@@ -133,6 +142,7 @@ public Map<String, String> addRequestHeader(String key, String value) {
 
   /**
    * Remove a request header.
+   *
    * @param key the header key to remove.
    * @return the new set of request headers.
    */
@@ -143,6 +153,7 @@ public Map<String, String> removeRequestHeader(String key) {
 
   /**
    * Get the SendGrid host (api.sendgrid.com by default).
+   *
    * @return the SendGrid host.
    */
   public String getHost() {
@@ -151,15 +162,16 @@ public String getHost() {
 
   /**
    * Set the SendGrid host.
+   *
    * @param host the new SendGrid host.
    */
   public void setHost(String host) {
     this.host = host;
   }
 
   /**
-   * Get the maximum number of retries on a rate limit response. 
-   * The default is 5.
+   * Get the maximum number of retries on a rate limit response. The default is 5.
+   *
    * @return the number of retries on a rate limit.
    */
   public int getRateLimitRetry() {
@@ -168,25 +180,26 @@ public int getRateLimitRetry() {
 
   /**
    * Set the maximum number of retries on a rate limit response.
+   *
    * @param rateLimitRetry the maximum retry count.
    */
   public void setRateLimitRetry(int rateLimitRetry) {
     this.rateLimitRetry = rateLimitRetry;
   }
 
   /**
-   * Get the duration of time (in milliseconds) to sleep between
-   * consecutive rate limit retries. The SendGrid API enforces
-   * the rate limit to the second. The default value is 1.1 seconds.
+   * Get the duration of time (in milliseconds) to sleep between consecutive rate limit retries. The
+   * SendGrid API enforces the rate limit to the second. The default value is 1.1 seconds.
+   *
    * @return the sleep duration.
    */
   public int getRateLimitSleep() {
     return this.rateLimitSleep;
   }
 
   /**
-   * Set the duration of time (in milliseconds) to sleep between
-   * consecutive rate limit retries.
+   * Set the duration of time (in milliseconds) to sleep between consecutive rate limit retries.
+   *
    * @param rateLimitSleep the sleep duration.
    */
   public void setRateLimitSleep(int rateLimitSleep) {
@@ -195,6 +208,7 @@ public void setRateLimitSleep(int rateLimitSleep) {
 
   /**
    * Makes the call to the SendGrid API, override this method for testing.
+   *
    * @param request the request to make.
    * @return the response object.
    * @throws IOException in case of a network error.
@@ -205,6 +219,7 @@ public Response makeCall(Request request) throws IOException {
 
   /**
    * Class api sets up the request to the SendGrid API, this is main interface.
+   *
    * @param request the request object.
    * @return the response object.
    * @throws IOException in case of a network error.
@@ -226,9 +241,9 @@ public Response api(Request request) throws IOException {
   }
 
   /**
-   * Attempt an API call. This method executes the API call asynchronously
-   * on an internal thread pool. If the call is rate limited, the thread
-   * will retry up to the maximum configured time.
+   * Attempt an API call. This method executes the API call asynchronously on an internal thread
+   * pool. If the call is rate limited, the thread will retry up to the maximum configured time.
+   *
    * @param request the API request.
    */
   public void attempt(Request request) {
@@ -243,10 +258,10 @@ public void response(Response r) {
   }
 
   /**
-   * Attempt an API call. This method executes the API call asynchronously
-   * on an internal thread pool. If the call is rate limited, the thread
-   * will retry up to the maximum configured time. The supplied callback
-   * will be called in the event of an error, or a successful response.
+   * Attempt an API call. This method executes the API call asynchronously on an internal thread
+   * pool. If the call is rate limited, the thread will retry up to the maximum configured time. The
+   * supplied callback will be called in the event of an error, or a successful response.
+   *
    * @param request the API request.
    * @param callback the callback.
    */

src/main/java/com/sendgrid/SendGridAPI.java

@@ -7,14 +7,14 @@ public interface SendGridAPI {
 
   /**
    * Initializes SendGrid
-   * 
+   *
    * @param apiKey is your SendGrid API Key: https://app.sendgrid.com/settings/api_keys
    */
   public void initializeSendGrid(String apiKey);
 
   /**
    * Returns the library version
-   * 
+   *
    * @return the library version.
    */
   public String getLibraryVersion();
@@ -28,20 +28,21 @@ public interface SendGridAPI {
 
   /**
    * Sets the version.
-   * 
+   *
    * @param version the SendGrid version.
    */
   public void setVersion(String version);
 
   /**
    * Gets the request headers.
+   *
    * @return returns a map of request headers.
    */
   public Map<String, String> getRequestHeaders();
 
   /**
    * Adds a request headers.
-   * 
+   *
    * @param key the key
    * @param value the value
    * @return returns a map of request headers.
@@ -50,30 +51,29 @@ public interface SendGridAPI {
 
   /**
    * Removes a request headers.
-   * 
+   *
    * @param key the key
    * @return returns a map of request headers.
    */
   public Map<String, String> removeRequestHeader(String key);
 
   /**
    * Gets the host.
-   * 
+   *
    * @return returns the host.
    */
   public String getHost();
 
   /**
    * Sets the host.
-   * 
+   *
    * @param host the host to set
    */
   public void setHost(String host);
 
   /**
-   * Class makeCall makes the call to the SendGrid API, override this method for
-   * testing.
-   * 
+   * Class makeCall makes the call to the SendGrid API, override this method for testing.
+   *
    * @param request the request
    * @return returns a response.
    * @throws IOException in case of network or marshal error.
@@ -82,7 +82,7 @@ public interface SendGridAPI {
 
   /**
    * Class api sets up the request to the SendGrid API, this is main interface.
-   * 
+   *
    * @param request the request
    * @return returns a response.
    * @throws IOException in case of network or marshal error.