Package com.algolia.search

Class AsyncAPIClientBuilder

java.lang.Object

com.algolia.search.GenericAPIClientBuilder

com.algolia.search.AsyncAPIClientBuilder

public abstract class AsyncAPIClientBuilder
extends GenericAPIClientBuilder

Base class to create AsyncAPIClient

Field Summary

Fields inherited from class com.algolia.search.GenericAPIClientBuilder

apiKey, applicationId, buildHosts, connectTimeout, customAgent, customAgentVersion, customHeaders, hostDownTimeout, maxConnTotal, objectMapper, queryHosts, random, readTimeout

Constructor Summary

Constructors

Constructor	Description
AsyncAPIClientBuilder(String applicationId, String apiKey)	Initialize this builder with the applicationId and apiKey

Method Summary

Modifier and Type	Method	Description
GenericAPIClientBuilder	addExtraHeader(String key, String value)	Add extra headers to the requests
AsyncAPIClient	build()	Build an AsyncAPIClient with a default executor of 10 threads
protected abstract AsyncAPIClient	build(AsyncAPIClientConfiguration configuration)
AsyncAPIClient	build(ExecutorService executor)	Build an AsyncAPIClient
AsyncAPIClientBuilder	setBuildHosts(List<String> buildHosts)	Set the hosts for indexing & building
AsyncAPIClientBuilder	setConnectTimeout(int connectTimeout)	Set the connect timeout of the HTTP client
AsyncAPIClientBuilder	setExtraHeader(String key, String value)	Deprecated.
AsyncAPIClientBuilder	setObjectMapper(com.fasterxml.jackson.databind.ObjectMapper objectMapper)	Set the Jackson ObjectMapper
AsyncAPIClientBuilder	setQueryHosts(List<String> queryHosts)	Set the hosts for search & queries
AsyncAPIClientBuilder	setReadTimeout(int readTimeout)	Set the read timeout of the HTTP client
AsyncAPIClientBuilder	setUserAgent(String customAgent, String customAgentVersion)	Customize the user agent

Methods inherited from class com.algolia.search.GenericAPIClientBuilder

generateBuildHosts, generateHeaders, generateQueryHosts, setHostDownTimeout, setMaxConnTotal

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AsyncAPIClientBuilder

public AsyncAPIClientBuilder(@Nonnull
                             String applicationId,
                             @Nonnull
                             String apiKey)

Initialize this builder with the applicationId and apiKey

Parameters:

applicationId - APP_ID can be found on https://www.algolia.com/api-keys

apiKey - Algolia API_KEY can also be found on https://www.algolia.com/api-keys

Method Detail

setUserAgent

public AsyncAPIClientBuilder setUserAgent(@Nonnull
                                          String customAgent,
                                          @Nonnull
                                          String customAgentVersion)

Customize the user agent

Overrides:

setUserAgent in class GenericAPIClientBuilder

Parameters:

customAgent - key to add to the user agent

customAgentVersion - value of this key to add to the user agent

Returns:

this

setExtraHeader

@Deprecated
public AsyncAPIClientBuilder setExtraHeader(@Nonnull
                                            String key,
                                            String value)

Deprecated.

Description copied from class: GenericAPIClientBuilder

Deprecated: use GenericAPIClientBuilder.addExtraHeader(String, String)

Overrides:

setExtraHeader in class GenericAPIClientBuilder

addExtraHeader

public GenericAPIClientBuilder addExtraHeader(@Nonnull
                                              String key,
                                              String value)

Description copied from class: GenericAPIClientBuilder

Add extra headers to the requests

Overrides:

addExtraHeader in class GenericAPIClientBuilder

Parameters:

key - name of the header

value - value of the header

Returns:

this

setConnectTimeout

public AsyncAPIClientBuilder setConnectTimeout(int connectTimeout)

Set the connect timeout of the HTTP client

Overrides:

setConnectTimeout in class GenericAPIClientBuilder

Parameters:

connectTimeout - the value in ms

Returns:

this

setReadTimeout

public AsyncAPIClientBuilder setReadTimeout(int readTimeout)

Set the read timeout of the HTTP client

Overrides:

setReadTimeout in class GenericAPIClientBuilder

Parameters:

readTimeout - the value in ms

Returns:

this

setObjectMapper

public AsyncAPIClientBuilder setObjectMapper(@Nonnull
                                             com.fasterxml.jackson.databind.ObjectMapper objectMapper)

Set the Jackson ObjectMapper

Overrides:

setObjectMapper in class GenericAPIClientBuilder

Parameters:

objectMapper - the mapper

Returns:

this

setQueryHosts

public AsyncAPIClientBuilder setQueryHosts(List<String> queryHosts)

Description copied from class: GenericAPIClientBuilder

Set the hosts for search & queries

Overrides:

setQueryHosts in class GenericAPIClientBuilder

Parameters:

queryHosts - the list of hosts for search

Returns:

this

setBuildHosts

public AsyncAPIClientBuilder setBuildHosts(List<String> buildHosts)

Description copied from class: GenericAPIClientBuilder

Set the hosts for indexing & building

Overrides:

setBuildHosts in class GenericAPIClientBuilder

Parameters:

buildHosts - the list of hosts for indexing/building

Returns:

this

build

protected abstract AsyncAPIClient build(@Nonnull
                                        AsyncAPIClientConfiguration configuration)

build

public AsyncAPIClient build()

Build an AsyncAPIClient with a default executor of 10 threads

Returns:

the built AsyncAPIClient

build

public AsyncAPIClient build(ExecutorService executor)

Build an AsyncAPIClient

Parameters:

executor - the executor to use

Returns:

the built AsyncAPIClient