Interface ListeningExecutorService
- All Superinterfaces:
AutoCloseable,Executor,ExecutorService
- All Known Subinterfaces:
ListeningScheduledExecutorService
- All Known Implementing Classes:
AbstractListeningExecutorService,DirectExecutorService,ForwardingListeningExecutorService,MoreExecutors.ListeningDecorator,MoreExecutors.ScheduledListeningDecorator,SameThreadScheduledExecutorService,TestingExecutors.NoOpScheduledExecutorService
An
ExecutorService that returns ListenableFuture instances. To create an instance
from an existing ExecutorService, call MoreExecutors.listeningDecorator(ExecutorService).- Since:
- 10.0
-
Method Summary
Modifier and TypeMethodDescriptiondefault booleanawaitTermination(Duration timeout) Duration-based overload ofExecutorService.awaitTermination(long, TimeUnit).invokeAll(Collection<? extends Callable<T>> tasks) invokeAll(Collection<? extends Callable<T>> tasks, long timeout, TimeUnit unit) invokeAll(Collection<? extends Callable<T>> tasks, Duration timeout) Duration-based overload ofinvokeAll(Collection, long, TimeUnit).default <T> TinvokeAny(Collection<? extends Callable<T>> tasks, Duration timeout) Duration-based overload ofExecutorService.invokeAny(Collection, long, TimeUnit).<T> ListenableFuture<T> <T> ListenableFuture<T> Methods inherited from interface java.util.concurrent.ExecutorService
awaitTermination, close, invokeAny, invokeAny, isShutdown, isTerminated, shutdown, shutdownNow
-
Method Details
-
submit
- Specified by:
submitin interfaceExecutorService- Returns:
- a
ListenableFuturerepresenting pending completion of the task
-
submit
- Specified by:
submitin interfaceExecutorService- Returns:
- a
ListenableFuturerepresenting pending completion of the task
-
submit
- Specified by:
submitin interfaceExecutorService- Returns:
- a
ListenableFuturerepresenting pending completion of the task
-
invokeAll
All elements in the returned list must be
ListenableFutureinstances. The easiest way to obtain aList<ListenableFuture<T>>from this method is an unchecked (but safe) cast:@SuppressWarnings("unchecked") // guaranteed by invokeAll contractList<ListenableFuture<T>> futures = (List) executor.invokeAll(tasks);- Specified by:
invokeAllin interfaceExecutorService- Returns:
- A list of
ListenableFutureinstances representing the tasks, in the same sequential order as produced by the iterator for the given task list, each of which has completed.
-
invokeAll
<T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks, long timeout, TimeUnit unit) throws InterruptedException All elements in the returned list must be
ListenableFutureinstances. The easiest way to obtain aList<ListenableFuture<T>>from this method is an unchecked (but safe) cast:@SuppressWarnings("unchecked") // guaranteed by invokeAll contractList<ListenableFuture<T>> futures = (List) executor.invokeAll(tasks, timeout, unit);- Specified by:
invokeAllin interfaceExecutorService- Returns:
- a list of
ListenableFutureinstances representing the tasks, in the same sequential order as produced by the iterator for the given task list. If the operation did not time out, each task will have completed. If it did time out, some of these tasks will not have completed.
-
invokeAll
default <T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks, Duration timeout) throws InterruptedException Duration-based overload ofinvokeAll(Collection, long, TimeUnit).- Throws:
InterruptedException- Since:
- 32.1.0
-
invokeAny
default <T> T invokeAny(Collection<? extends Callable<T>> tasks, Duration timeout) throws InterruptedException, ExecutionException, TimeoutException Duration-based overload ofExecutorService.invokeAny(Collection, long, TimeUnit).- Throws:
InterruptedExceptionExecutionExceptionTimeoutException- Since:
- 32.1.0
-
awaitTermination
Duration-based overload ofExecutorService.awaitTermination(long, TimeUnit).- Throws:
InterruptedException- Since:
- 32.1.0
-