Package org.apache.lucene.search
Class TaskExecutor
- java.lang.Object
-
- org.apache.lucene.search.TaskExecutor
-
public final class TaskExecutor extends Object
Executor wrapper responsible for the execution of concurrent tasks. Used to parallelize search across segments as well as query rewrite in some cases. Exposes a singleinvokeAll(Collection)
method that takes a collection ofCallable
s and executes them concurrently/ Once all tasks are submitted to the executor, it blocks and wait for all tasks to be completed, and then returns a list with the obtained results. Ensures that the underlying executor is only used for top-levelinvokeAll(Collection)
calls, and not for potentialinvokeAll(Collection)
calls made from one of the tasks. This is to prevent deadlock with certain types of pool based executors (e.g.ThreadPoolExecutor
).- WARNING: This API is experimental and might change in incompatible ways in the next release.
-
-
Constructor Summary
Constructors Constructor Description TaskExecutor(Executor executor)
Creates a TaskExecutor instance
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description <T> List<T>
invokeAll(Collection<Callable<T>> callables)
Execute all the callables provided as an argument, wait for them to complete and return the obtained results.String
toString()
-
-
-
Constructor Detail
-
TaskExecutor
public TaskExecutor(Executor executor)
Creates a TaskExecutor instance- Parameters:
executor
- the executor to be used for running tasks concurrently
-
-
Method Detail
-
invokeAll
public <T> List<T> invokeAll(Collection<Callable<T>> callables) throws IOException
Execute all the callables provided as an argument, wait for them to complete and return the obtained results. If an exception is thrown by more than one callable, the subsequent ones will be added as suppressed exceptions to the first one that was caught.- Type Parameters:
T
- the return type of the task execution- Parameters:
callables
- the callables to execute- Returns:
- a list containing the results from the tasks execution
- Throws:
IOException
-
-