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:/google/google-java-format
- https://plugins.jetbrains.com/plugin/8527-google-java-format
- https:/google/styleguide/blob/gh-pages/intellij-java-google-style.xml

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.