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

Class AbstractExecutorService

public abstract class AbstractExecutorService extends 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.
 }
 

Since: 1.5

Author: Doug Lea

Method Summary
ListinvokeAll(Collection tasks)
ListinvokeAll(Collection tasks, long timeout, TimeUnit unit)
ObjectinvokeAny(Collection tasks)
ObjectinvokeAny(Collection tasks, long timeout, TimeUnit unit)
protected RunnableFuturenewTaskFor(Runnable runnable, Object value)
Returns a RunnableFuture for the given runnable and default value.
protected RunnableFuturenewTaskFor(Callable callable)
Returns a RunnableFuture for the given callable task.
Futuresubmit(Runnable task)
Futuresubmit(Runnable task, Object result)
Futuresubmit(Callable task)

Method Detail

invokeAll

public List invokeAll(Collection tasks)

invokeAll

public List invokeAll(Collection tasks, long timeout, TimeUnit unit)

invokeAny

public Object invokeAny(Collection tasks)

invokeAny

public Object invokeAny(Collection tasks, long timeout, TimeUnit unit)

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)

Throws: RejectedExecutionException {@inheritDoc } NullPointerException {@inheritDoc }

submit

public Future submit(Runnable task, Object result)

Throws: RejectedExecutionException {@inheritDoc } NullPointerException {@inheritDoc }

submit

public Future submit(Callable task)

Throws: RejectedExecutionException {@inheritDoc } NullPointerException {@inheritDoc }