org.hibernate.search.elasticsearch.processor.impl

Class ElasticsearchWorkProcessor

java.lang.Object

org.hibernate.search.elasticsearch.processor.impl.ElasticsearchWorkProcessor

All Implemented Interfaces:

AutoCloseable

public class ElasticsearchWorkProcessor
extends Object
implements AutoCloseable

Executes single or multiple ElasticsearchWorks against the Elasticsearch server.

When processing multiple requests, bulk requests will be formed and executed as far as possible.

Requests can be processed synchronously or asynchronously. In the latter case, incoming requests are added to a queue via AsyncBackendRequestProcessor from where a worker runnable will process them in bulks.

Author:

Gunnar Morling

Constructor Summary

Constructors

Constructor and Description
ElasticsearchWorkProcessor(BuildContext context, ElasticsearchClient client, GsonProvider gsonProvider, ElasticsearchWorkFactory workFactory)

Method Summary

Modifier and Type	Method and Description
void	awaitAsyncProcessingCompletion() Blocks until the queue of requests scheduled for asynchronous processing has been fully processed.
void	close()
void	executeAsync(ElasticsearchWork<?> work) Execute a single work asynchronously.
void	executeAsync(List<ElasticsearchWork<?>> works) Execute a set of works asynchronously.
void	executeSyncSafe(Iterable<ElasticsearchWork<?>> works) Execute a set of works synchronously.
<T> T	executeSyncUnsafe(ElasticsearchWork<T> work) Execute a single work synchronously, potentially throwing exceptions (the error handler isn't used).

Methods inherited from class java.lang.Object

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

Constructor Detail

ElasticsearchWorkProcessor

public ElasticsearchWorkProcessor(BuildContext context,
                                  ElasticsearchClient client,
                                  GsonProvider gsonProvider,
                                  ElasticsearchWorkFactory workFactory)

Method Detail

close

public void close()

Specified by:

close in interface AutoCloseable

executeSyncUnsafe

public <T> T executeSyncUnsafe(ElasticsearchWork<T> work)

Execute a single work synchronously, potentially throwing exceptions (the error handler isn't used).

Parameters:

work - The work to be executed.

Returns:

The result of the given work.

executeSyncSafe

public void executeSyncSafe(Iterable<ElasticsearchWork<?>> works)

Execute a set of works synchronously.

Works submitted in the same list will be executed in the given order.

If any work throws an exception, this exception will be passed to the error handler with an ErrorContext spanning at least the given works, and the remaining works will not be executed.

Parameters:

works - The works to be executed.

executeAsync

public void executeAsync(ElasticsearchWork<?> work)

Execute a single work asynchronously.

If the work throws an exception, this exception will be passed to the error handler with an ErrorContext spanning at least this work.

Parameters:

work - The work to be executed.

executeAsync

public void executeAsync(List<ElasticsearchWork<?>> works)

Execute a set of works asynchronously.

Works submitted in the same list will be executed in the given order.

If any work throws an exception, this exception will be passed to the error handler with an ErrorContext spanning at least the given works, and the remaining works will not be executed.

Parameters:

works - The works to be executed.

awaitAsyncProcessingCompletion

public void awaitAsyncProcessingCompletion()

Blocks until the queue of requests scheduled for asynchronous processing has been fully processed. N.B. if more work is added to the queue in the meantime, this might delay the wait.