ro.isdc.wro.util.concurrent

Class TaskExecutor<T>

java.lang.Object

ro.isdc.wro.util.concurrent.TaskExecutor<T>

public class TaskExecutor<T>
extends Object

Hides the details of running tasks in parallel.

Since:

1.7.1

Author:

Alex Objelean

Constructor Summary

Constructors

Constructor and Description
TaskExecutor()

Method Summary

Methods

Modifier and Type	Method and Description
void	destroy() Shutdown all executors used by this class.
protected ExecutorService	newExecutor() The implementation uses jsr166 ForkJoinPool implementation in case it is available and can be used, otherwise the default ExecutorService is used.
protected void	onException(Exception e) Invoked when an exception occurs during task execution.
protected void	onResultAvailable(T result) A callback invoked when a result is available.
void	submit(Collection<Callable<T>> callables) TODO rename to submitAll.

Methods inherited from class java.lang.Object

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

Constructor Detail

TaskExecutor

public TaskExecutor()

Method Detail

newExecutor

protected ExecutorService newExecutor()

The implementation uses jsr166 ForkJoinPool implementation in case it is available and can be used, otherwise the default ExecutorService is used.

Returns:

the ExecutorService responsible for running the tasks.

submit

public void submit(Collection<Callable<T>> callables)
            throws Exception

TODO rename to submitAll.

Submits a chunk of jobs for parallel execution. This is a blocking operation - it will end execution when all submitted tasks are finished.

Parameters:

callables - a Collection of Callable to execute. When the provided collection contains only one item, the task will be executed synchronously.

Throws:

Exception - if an exception occurred during callable execution.

onException

protected void onException(Exception e)
                    throws Exception

Invoked when an exception occurs during task execution. By default exception is ignored.

Parameters:

e - Exception caught during execution.

Throws:

Exception

onResultAvailable

protected void onResultAvailable(T result)
                          throws Exception

A callback invoked when a result is available.

Parameters:

result - the available processed result.

Throws:

Exception - if callback execution fails.

destroy

public void destroy()

Shutdown all executors used by this class.