com.algolia.search.DefaultInsightsClient Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of algoliasearch-apache Show documentation

The newest version!

package com.algolia.search;

import javax.annotation.Nonnull;

/**
 * Algolia's REST insights client that wraps an instance of the transporter. which wraps the HTTP
 * Client This client allows to build typed requests and read typed responses. Requests are made
 * under the Algolia's retry-strategy. This client is intended to be reused and it's thread-safe.
 *
 * @see Algolia.com
 */
@SuppressWarnings("WeakerAccess")
public class DefaultInsightsClient {

  /**
   * Creates a default {@link InsightsClient} with the given credentials. The default HttpClient
   * implementation is {@link ApacheHttpRequester}
   *
   * @param applicationID The Algolia Application ID
   * @param apiKey The Algolia API Key
   * @throws NullPointerException If one of the following ApplicationID/ApiKey is null
   * @throws IllegalArgumentException If the ApplicationID or the APIKey are empty
   */
  public static InsightsClient create(@Nonnull String applicationID, @Nonnull String apiKey) {
    return create(new InsightsConfig.Builder(applicationID, apiKey).build());
  }

  /**
   * Creates a default {@link InsightsClient} with the given {@link InsightsConfig}. The default
   * HttpClient implementation is {@link ApacheHttpRequester}
   *
   * @param config The configuration allows you to advanced configuration of the clients such as
   *     batch size or custom hosts and timeout.
   * @throws NullPointerException If one of the following ApplicationID/ApiKey/Config is null
   * @throws IllegalArgumentException If the ApplicationID or the APIKey are empty
   */
  public static InsightsClient create(@Nonnull InsightsConfig config) {
    return new InsightsClient(config, new ApacheHttpRequester(config));
  }
}