Merge pull request #59 from SparkPost/feature/httpclient_4_5_3_compat_issue57

Fixes some javadoc errors

Author: yepher

libs/sparkpost-lib/src/main/java/com/sparkpost/transport/IRestConnection.java

@@ -31,7 +31,7 @@ public interface IRestConnection {
      * Perform an HTTP GET request. This method throws an exception if the
      * server returns anything else than a 200.
      *
-     * @param path
+     * @param endpoint
      *            API endpoint to send the request to.
      * @return Server response to the request.
      * @throws SparkPostException
@@ -58,11 +58,11 @@ public interface IRestConnection {
      * Perform an HTTP POST request. This method throws an exception if the
      * server returns anything else than a 200.
      *
-     * @param path
+     * @param endpoint
      *            API endpoint to send the request to.
      * @param json
      *            POST data block to send with the request. May be null.
-     * @return Server response to the request.
+     * @return Server response to the request
      * @throws SparkPostException
      *             if something goes wrong
      */
@@ -88,7 +88,7 @@ public interface IRestConnection {
      * Perform an HTTP PUT request. This method throws an exception if the
      * server returns anything else than a 200.
      *
-     * @param path
+     * @param endpoint
      *            API endpoint to send the request to.
      * @param json
      *            PUT data block to send with the request. May be null.

libs/sparkpost-lib/src/main/java/com/sparkpost/transport/RestConnection.java

@@ -63,20 +63,22 @@ public enum Method {
      * @param client
      *            Client object to use (in particular for authentication info)
      * @throws SparkPostException
+     *             if something goes wrong
      */
     public RestConnection(Client client) throws SparkPostException {
         this(client, "" /* means:set to default endpoint */);
     }
 
     /**
-     * Create a REST connection object. The given {@link endpoint} will be used
+     * Create a REST connection object. The given baseUrl will be used
      * for connections
      *
      * @param client
      *            Client object to use (in particular for authentication info)
      * @param baseUrl
      *            Endpoint to use instead of the default defaultApiEndpoint
      * @throws SparkPostException
+     *             if something goes wrong
      */
     public RestConnection(Client client, String baseUrl) throws SparkPostException {
 
@@ -102,6 +104,7 @@ public RestConnection(Client client, String baseUrl) throws SparkPostException {
      *            HTTP method for the connection
      * @return the connection object
      * @throws SparkPostException
+     *             if something goes wrong
      */
     private HttpURLConnection createConnectionObject(String path, Method method) throws SparkPostException {
         HttpURLConnection conn;