Class ExecutionList
java.lang.Object
com.google.common.util.concurrent.ExecutionList
A support class for
ListenableFuture implementations to manage their listeners. An
instance contains a list of listeners, each with an associated Executor, and guarantees
that every Runnable that is added will be executed after execute() is called. Any Runnable added after the call to execute is still
guaranteed to execute. There is no guarantee, however, that listeners will be executed in the
order that they are added.
Exceptions thrown by a listener will be propagated up to the executor. Any exception thrown
during Executor.execute (e.g., a RejectedExecutionException or an exception
thrown by direct execution) will be caught and logged.
- Since:
- 1.0
-
Nested Class Summary
Nested Classes -
Field Summary
FieldsModifier and TypeFieldDescriptionprivate booleanprivate static final LazyLoggerLogger to log exceptions caught when running runnables.The runnable, executor pairs to execute. -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidAdds theRunnableand accompanyingExecutorto the list of listeners to execute.voidexecute()Runs this execution list, executing all existing pairs in the order they were added.private static voidexecuteListener(Runnable runnable, Executor executor) Submits the given runnable to the givenExecutorcatching and logging all runtime exceptions thrown by the executor.
-
Field Details
-
log
Logger to log exceptions caught when running runnables. -
runnables
The runnable, executor pairs to execute. This acts as a stack threaded through theExecutionList.RunnableExecutorPair.nextfield. -
executed
private boolean executed
-
-
Constructor Details
-
ExecutionList
public ExecutionList()Creates a new, emptyExecutionList.
-
-
Method Details
-
add
Adds theRunnableand accompanyingExecutorto the list of listeners to execute. If execution has already begun, the listener is executed immediately.When selecting an executor, note that
directExecutoris dangerous in some cases. See the discussion in theListenableFuture.addListenerdocumentation. -
execute
public void execute()Runs this execution list, executing all existing pairs in the order they were added. However, note that listeners added after this point may be executed before those previously added, and note that the execution order of all listeners is ultimately chosen by the implementations of the supplied executors.This method is idempotent. Calling it several times in parallel is semantically equivalent to calling it exactly once.
- Since:
- 10.0 (present in 1.0 as
run)
-
executeListener
Submits the given runnable to the givenExecutorcatching and logging all runtime exceptions thrown by the executor.
-