org.hibernate.search.engine.backend.orchestration.spi

Class BatchingExecutor<W extends BatchingExecutor.WorkSet<? super P>,P extends BatchingExecutor.WorkProcessor>

java.lang.Object

org.hibernate.search.engine.backend.orchestration.spi.BatchingExecutor<W,P>

public final class BatchingExecutor<W extends BatchingExecutor.WorkSet<? super P>,P extends BatchingExecutor.WorkProcessor>
extends Object

An executor of works that accepts works from multiple threads, puts them in a queue, and processes them in batches in a single background thread.

Useful when works can be merged together for optimization purposes (bulking in Elasticsearch), or when they should never be executed in parallel (writes to a Lucene index).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	BatchingExecutor.WorkProcessor
static interface	BatchingExecutor.WorkSet<P extends BatchingExecutor.WorkProcessor>

Constructor Summary

Constructors

Constructor and Description
BatchingExecutor(String name, P processor, int maxTasksPerBatch, boolean fair, FailureHandler failureHandler)

Method Summary

Modifier and Type	Method and Description
CompletableFuture<?>	getCompletion()
void	start(ThreadPoolProvider threadPoolProvider) Start the executor, allowing works to be submitted through submit(WorkSet).
void	stop() Stop the executor, no longer allowing works to be submitted through submit(WorkSet).
void	submit(W workset) Submit a set of works for execution.

Methods inherited from class java.lang.Object

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

Constructor Detail

BatchingExecutor

public BatchingExecutor(String name,
                        P processor,
                        int maxTasksPerBatch,
                        boolean fair,
                        FailureHandler failureHandler)

Parameters:

name - The name of the executor thread (and of this executor when reporting errors)

processor - A task processor. May not be thread-safe.

maxTasksPerBatch - The maximum number of tasks to process in a single batch. Higher values mean more opportunity for the processor to optimize execution, but higher heap consumption.

fair - if true tasks are always submitted to the processor in FIFO order, if false tasks submitted when the internal queue is full may be submitted out of order.

failureHandler - A failure handler to report failures of the background thread.

Method Detail

start

public void start(ThreadPoolProvider threadPoolProvider)

Start the executor, allowing works to be submitted through submit(WorkSet).

Parameters:

threadPoolProvider - A provider of thread pools.

stop

public void stop()

Stop the executor, no longer allowing works to be submitted through submit(WorkSet).

This will attempt to forcibly terminate currently executing works, and will remove pending works from the queue.

submit

public void submit(W workset)
            throws InterruptedException

Submit a set of works for execution.

Must not be called when the executor is stopped.

Parameters:

workset - A set of works to execute.

Throws:

InterruptedException - If the current thread is interrupted while enqueuing the workset.

getCompletion

public CompletableFuture<?> getCompletion()

Returns:

A future that completes when all works submitted to the executor so far are completely executed. Works submitted to the executor after entering this method may delay the wait.