edu.emory.mathcs.backport.java.util.concurrent

Class AbstractExecutorService

Implemented Interfaces:
Executor, ExecutorService
Known Direct Subclasses:
ThreadPoolExecutor

public abstract class AbstractExecutorService
extends java.lang.Object
implements ExecutorService

Provides default implementations of ExecutorService execution methods. This class implements the submit, invokeAny and invokeAll methods using a RunnableFuture returned by newTaskFor, which defaults to the FutureTask class provided in this package. For example, the implementation of submit(Runnable) creates an associated RunnableFuture that is executed and returned. Subclasses may override the newTaskFor methods to return RunnableFuture implementations other than FutureTask.

Extension example. Here is a sketch of a class that customizes ThreadPoolExecutor to use a CustomTask class instead of the default FutureTask:

 public class CustomThreadPoolExecutor extends ThreadPoolExecutor {

   static class CustomTask<V> implements RunnableFuture<V> {...}

   protected <V> RunnableFuture<V> newTaskFor(Callable<V> c) {
       return new CustomTask<V>(c);
   }
   protected <V> RunnableFuture<V> newTaskFor(Runnable r, V v) {
       return new CustomTask<V>(r, v);
   }
   // ... add constructors, etc.
 }
 
Author:
Doug Lea
Since:
1.5

Method Summary

List
invokeAll(Collection tasks)
List
invokeAll(Collection tasks, long timeout, TimeUnit unit)
Object
invokeAny(Collection tasks)
Object
invokeAny(Collection tasks, long timeout, TimeUnit unit)
protected RunnableFuture
newTaskFor(Runnable runnable, Object value)
Returns a RunnableFuture for the given runnable and default value.
protected RunnableFuture
newTaskFor(Callable callable)
Returns a RunnableFuture for the given callable task.
Future
submit(Runnable task)
Future
submit(Runnable task, Object result)
Future
submit(Callable task)

Method Details

invokeAll

public List invokeAll(Collection tasks)
            throws InterruptedException
Specified by:
invokeAll in interface ExecutorService

invokeAll

public List invokeAll(Collection tasks,
                      long timeout,
                      TimeUnit unit)
            throws InterruptedException
Specified by:
invokeAll in interface ExecutorService

invokeAny

public Object invokeAny(Collection tasks)
            throws InterruptedException,
                   ExecutionException
Specified by:
invokeAny in interface ExecutorService

invokeAny

public Object invokeAny(Collection tasks,
                        long timeout,
                        TimeUnit unit)
            throws InterruptedException,
                   ExecutionException,
                   TimeoutException
Specified by:
invokeAny in interface ExecutorService

newTaskFor

protected RunnableFuture newTaskFor(Runnable runnable,
                                    Object value)
Returns a RunnableFuture for the given runnable and default value.
Parameters:
runnable - the runnable task being wrapped
value - the default value for the returned future
Returns:
a RunnableFuture which when run will run the underlying runnable and which, as a Future, will yield the given value as its result and provide for cancellation of the underlying task.
Since:
1.6

newTaskFor

protected RunnableFuture newTaskFor(Callable callable)
Returns a RunnableFuture for the given callable task.
Parameters:
callable - the callable task being wrapped
Returns:
a RunnableFuture which when run will call the underlying callable and which, as a Future, will yield the callable's result as its result and provide for cancellation of the underlying task.
Since:
1.6

submit

public Future submit(Runnable task)
Specified by:
submit in interface ExecutorService

submit

public Future submit(Runnable task,
                     Object result)
Specified by:
submit in interface ExecutorService

submit

public Future submit(Callable task)
Specified by:
submit in interface ExecutorService