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

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

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and 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.
GenericAPIClientBuilder	setHostDownTimeout(int hostDownTimeout) Set the retry timeout to detect if a host is down
GenericAPIClientBuilder	setMaxConnPerRoute(int maxConnPerRoute) Set the maximum of connection per route, only available for ApacheAPIClientBuilder and AsyncAPIClientBuilder
GenericAPIClientBuilder	setMaxConnTotal(int maxConnTotal) Set the maximum of connection, only available for ApacheAPIClientBuilder and AsyncAPIClientBuilder
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, setAnalyticsHost

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

setHostDownTimeout

public GenericAPIClientBuilder setHostDownTimeout(int hostDownTimeout)

Description copied from class: GenericAPIClientBuilder

Set the retry timeout to detect if a host is down

Overrides:

setHostDownTimeout in class GenericAPIClientBuilder

Parameters:

hostDownTimeout - the value in ms

Returns:

this

setMaxConnTotal

public GenericAPIClientBuilder setMaxConnTotal(int maxConnTotal)

Description copied from class: GenericAPIClientBuilder

Set the maximum of connection, only available for ApacheAPIClientBuilder and AsyncAPIClientBuilder

Overrides:

setMaxConnTotal in class GenericAPIClientBuilder

Parameters:

maxConnTotal - the max number of connections

Returns:

this

setMaxConnPerRoute

public GenericAPIClientBuilder setMaxConnPerRoute(int maxConnPerRoute)

Description copied from class: GenericAPIClientBuilder

Set the maximum of connection per route, only available for ApacheAPIClientBuilder and AsyncAPIClientBuilder

Overrides:

setMaxConnPerRoute in class GenericAPIClientBuilder

Parameters:

maxConnPerRoute - the max number of connections per route

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