feat: java client APIC-160 (#29)

Author: millotp

.gitignore

@@ -14,3 +14,6 @@ yarn-error.log
 **/dist
 
 .vscode
+target
+
+**/.DS_Store

clients/algoliasearch-client-java-2/.gitignore

@@ -0,0 +1,20 @@
+*.class
+
+# Mobile Tools for Java (J2ME)
+.mtj.tmp/
+
+# Package Files #
+*.jar
+*.war
+*.ear
+
+# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
+hs_err_pid*
+
+# build files
+**/target
+target
+.gradle
+build
+
+.openapi-generator

clients/algoliasearch-client-java-2/.openapi-generator-ignore

@@ -0,0 +1,21 @@
+# OpenAPI Generator Ignore
+# Generated by openapi-generator https://github.com/openapitools/openapi-generator
+
+# Use this file to prevent files from being overwritten by the generator.
+# The patterns follow closely to .gitignore or .dockerignore.
+
+api/**
+docs/**
+gradle/**
+src/**
+
+.travis.yml
+build.gradle
+build.sbt
+git_push.sh
+gradle*
+settings.gradle
+
+# Selective source file
+algoliasearch-core/com/algolia/auth/**
+algoliasearch-core/com/algolia/Configuration.java

clients/algoliasearch-client-java-2/README.md

@@ -0,0 +1,68 @@
+# algoliasearch-client-java-2
+
+Search API
+- API version: 0.1.0
+
+API powering the Search feature of Algolia.
+
+*Automatically generated by the [OpenAPI Generator](https://openapi-generator.tech)*
+
+## Requirements
+
+Building the API client library requires:
+1. Java 1.8+
+2. Maven/Gradle
+
+## Installation
+
+To install the API client library to your local Maven repository, simply execute:
+
+```shell
+mvn clean install
+```
+
+To deploy it to a remote Maven repository instead, configure the settings of the repository and execute:
+
+```shell
+mvn clean deploy
+```
+
+Refer to the [OSSRH Guide](http://central.sonatype.org/pages/ossrh-guide.html) for more information.
+
+### Maven users
+
+Add this dependency to your project's POM:
+
+```xml
+<dependency>
+  <groupId>com.algolia</groupId>
+  <artifactId>algoliasearch-client-java-2</artifactId>
+  <version>0.1.0</version>
+  <scope>compile</scope>
+</dependency>
+```
+
+### Gradle users
+
+Add this dependency to your project's build file:
+
+```groovy
+compile "com.algolia:algoliasearch-client-java-2:0.1.0"
+```
+
+### Others
+
+At first generate the JAR by executing:
+
+```shell
+mvn clean package
+```
+
+Then manually install the following JARs:
+
+* `target/algoliasearch-client-java-2-0.1.0.jar`
+* `target/lib/*.jar`
+
+## Getting Started
+
+Checkout the playground.

clients/algoliasearch-client-java-2/algoliasearch-core/com/algolia/ApiCallback.java

@@ -0,0 +1,55 @@
+package com.algolia;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Callback for asynchronous API call.
+ *
+ * @param <T> The return type
+ */
+public interface ApiCallback<T> {
+  /**
+   * This is called when the API call fails.
+   *
+   * @param e The exception causing the failure
+   * @param statusCode Status code of the response if available, otherwise it would be 0
+   * @param responseHeaders Headers of the response if available, otherwise it would be null
+   */
+  void onFailure(
+    ApiException e,
+    int statusCode,
+    Map<String, List<String>> responseHeaders
+  );
+
+  /**
+   * This is called when the API call succeeded.
+   *
+   * @param result The result deserialized from response
+   * @param statusCode Status code of the response
+   * @param responseHeaders Headers of the response
+   */
+  void onSuccess(
+    T result,
+    int statusCode,
+    Map<String, List<String>> responseHeaders
+  );
+
+  /**
+   * This is called when the API upload processing.
+   *
+   * @param bytesWritten bytes Written
+   * @param contentLength content length of request body
+   * @param done write end
+   */
+  void onUploadProgress(long bytesWritten, long contentLength, boolean done);
+
+  /**
+   * This is called when the API download processing.
+   *
+   * @param bytesRead bytes Read
+   * @param contentLength content length of the response
+   * @param done Read end
+   */
+  void onDownloadProgress(long bytesRead, long contentLength, boolean done);
+}