javascalautils.concurrent

Interface Executor

public interface Executor

Executor service used to execute work in asynchronous fashion.
In contrast to the Executor service provided by the Java SDK this returns non-blocking Future instances.

Since:

1.2

Author:

Peter Nerg

Method Summary

Modifier and Type	Method and Description
boolean	awaitTermination(long timeout, TimeUnit unit) Blocks until all tasks have completed execution after a shutdown request, or the timeout occurs, or the current thread is interrupted, whichever happens first.
<T> Future<T>	execute(Callable<T> callable) Executes the provided Callable sometime in the future.
<T> Future<T>	execute(Executable<T> executable) Executes the provided Executable sometime in the future.
<T> List<Future<T>>	executeAll(Callable<T>... callables) Executes the list of provided Callable sometime in the future.
<T> List<Future<T>>	executeAll(Executable<T>... executables) Executes the list of provided Executable sometime in the future.
void	shutdown() Initiates an orderly shutdown in which previously submitted tasks are executed, but no new tasks will be accepted.

Method Detail

execute

<T> Future<T> execute(Executable<T> executable)

Executes the provided Executable sometime in the future.

Type Parameters:

T - The type the Future is expected to deliver

Parameters:

executable - The executable to execute

Returns:

The future acting as a place holder for a response-to-be

Since:

1.2

execute

<T> Future<T> execute(Callable<T> callable)

Executes the provided Callable sometime in the future.

Type Parameters:

T - The type the Future is expected to deliver

Parameters:

callable - The callable to execute

Returns:

The future acting as a place holder for a response-to-be

Since:

1.2

executeAll

<T> List<Future<T>> executeAll(Executable<T>... executables)

Executes the list of provided Executable sometime in the future.

Type Parameters:

T - The type the Future is expected to deliver

Parameters:

executables - The list of executables to execute

Returns:

List of futures acting as a place holder for a response-to-be

Since:

1.2

executeAll

<T> List<Future<T>> executeAll(Callable<T>... callables)

Executes the list of provided Callable sometime in the future.

Type Parameters:

T - The type the Future is expected to deliver

Parameters:

callables - The list of callables to execute

Returns:

List of futures acting as a place holder for a response-to-be

Since:

1.2

shutdown

void shutdown()

Initiates an orderly shutdown in which previously submitted tasks are executed, but no new tasks will be accepted. Invocation has no additional effect if already shut down.

Since:

1.2

awaitTermination

boolean awaitTermination(long timeout,
                         TimeUnit unit)
                  throws InterruptedException

Blocks until all tasks have completed execution after a shutdown request, or the timeout occurs, or the current thread is interrupted, whichever happens first.

Parameters:

timeout - the maximum time to wait

unit - the time unit of the timeout argument

Returns:

true if this executor terminated and false if the timeout elapsed before termination

Throws:

InterruptedException - if interrupted while waiting

Since:

1.2