Add a variant of waitTask with integer task ID (#343)

The `taskID` field returned by the API is always an integer. Exposing a string in the API Client is confusing. => This change exposes an overloaded method with integer argument, and deprecates the string variant.

Author: Clément Le Provost

algoliasearch/src/main/java/com/algolia/search/saas/Index.java

@@ -479,6 +479,8 @@ public Request getObjectsAsync(final @NonNull List<String> objectIDs, final List
      * @param taskID            Identifier of the task (as returned by the server).
      * @param completionHandler The listener that will be notified of the request's outcome.
      * @return A cancellable request.
+     *
+     * @deprecated Task IDs are always integers. Please use {@link #waitTaskAsync(int, CompletionHandler)} instead.
      */
     public Request waitTaskAsync(final @NonNull String taskID, @NonNull CompletionHandler completionHandler) {
         return getClient().new AsyncTaskRequest(completionHandler) {
@@ -489,6 +491,23 @@ public Request waitTaskAsync(final @NonNull String taskID, @NonNull CompletionHa
         }.start();
     }
 
+    /**
+     * Wait until the publication of a task on the server (helper).
+     * All server tasks are asynchronous. This method helps you check that a task is published.
+     *
+     * @param taskID            Identifier of the task (as returned by the server).
+     * @param completionHandler The listener that will be notified of the request's outcome.
+     * @return A cancellable request.
+     */
+    public Request waitTaskAsync(final int taskID, @NonNull CompletionHandler completionHandler) {
+        return getClient().new AsyncTaskRequest(completionHandler) {
+            @NonNull
+            @Override protected JSONObject run() throws AlgoliaException {
+                return waitTask(Integer.toString(taskID));
+            }
+        }.start();
+    }
+
     /**
      * Delete an object from this index (asynchronously).
      *

algoliasearch/src/test/java/com/algolia/search/saas/IndexTest.java

@@ -452,7 +452,7 @@ public void waitTaskAsync() throws Exception {
         index.addObjectAsync(new JSONObject("{\"city\": \"New York\"}"), new AssertCompletionHandler() {
             @Override public void doRequestCompleted(JSONObject content, AlgoliaException error) {
                 if (error == null) {
-                    index.waitTaskAsync(content.optString("taskID"), new AssertCompletionHandler() {
+                    index.waitTaskAsync(content.optInt("taskID"), new AssertCompletionHandler() {
                         @Override
                         public void doRequestCompleted(JSONObject content, AlgoliaException error) {
                             if (error == null) {