|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectjava.util.concurrent.AbstractExecutorService
public abstract class AbstractExecutorService
Provides default implementation of ExecutorService
execution methods. This class implements the submit,
invokeAny and invokeAll methods using the default
FutureTask class provided in this package. For example,
the implementation of submit(Runnable) creates an
associated FutureTask that is executed and
returned. Subclasses overriding these methods to use different
Future implementations should do so consistently for each
of these methods.
| Constructor Summary | |
|---|---|
AbstractExecutorService()
|
|
| Method Summary | ||
|---|---|---|
|
invokeAll(Collection<Callable<T>> tasks)
Executes the given tasks, returning a list of Futures holding their status and results when all complete. |
|
|
invokeAll(Collection<Callable<T>> tasks,
long timeout,
TimeUnit unit)
Executes the given tasks, returning a list of Futures holding their status and results when all complete or the timeout expires, whichever happens first. |
|
|
invokeAny(Collection<Callable<T>> tasks)
Executes the given tasks, returning the result of one that has completed successfully (i.e., without throwing an exception), if any do. |
|
|
invokeAny(Collection<Callable<T>> tasks,
long timeout,
TimeUnit unit)
Executes the given tasks, returning the result of one that has completed successfully (i.e., without throwing an exception), if any do before the given timeout elapses. |
|
|
submit(Callable<T> task)
Submits a value-returning task for execution and returns a Future representing the pending results of the task. |
|
Future<?> |
submit(Runnable task)
Submits a Runnable task for execution and returns a Future representing that task. |
|
|
submit(Runnable task,
T result)
Submits a Runnable task for execution and returns a Future representing that task that will upon completion return the given result |
|
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Methods inherited from interface java.util.concurrent.ExecutorService |
|---|
awaitTermination, isShutdown, isTerminated, shutdown, shutdownNow |
| Methods inherited from interface java.util.concurrent.Executor |
|---|
execute |
| Constructor Detail |
|---|
public AbstractExecutorService()
| Method Detail |
|---|
public Future<?> submit(Runnable task)
ExecutorService
submit in interface ExecutorServicetask - the task to submit
public <T> Future<T> submit(Runnable task,
T result)
ExecutorService
submit in interface ExecutorServicetask - the task to submitresult - the result to return
public <T> Future<T> submit(Callable<T> task)
ExecutorServiceIf you would like to immediately block waiting for a task, you can use constructions of the form result = exec.submit(aCallable).get();
Note: The Executors class includes a set of methods
that can convert some other common closure-like objects,
for example, PrivilegedAction to
Callable form so they can be submitted.
submit in interface ExecutorServicetask - the task to submit
public <T> T invokeAny(Collection<Callable<T>> tasks)
throws InterruptedException,
ExecutionException
ExecutorService
invokeAny in interface ExecutorServicetasks - the collection of tasks
InterruptedException - if interrupted while waiting
ExecutionException - if no task successfully completes
public <T> T invokeAny(Collection<Callable<T>> tasks,
long timeout,
TimeUnit unit)
throws InterruptedException,
ExecutionException,
TimeoutException
ExecutorService
invokeAny in interface ExecutorServicetasks - the collection of taskstimeout - the maximum time to waitunit - the time unit of the timeout argument
InterruptedException - if interrupted while waiting
ExecutionException - if no task successfully completes
TimeoutException - if the given timeout elapses before
any task successfully completes
public <T> List<Future<T>> invokeAll(Collection<Callable<T>> tasks)
throws InterruptedException
ExecutorServiceFuture.isDone() is true for each
element of the returned list.
Note that a completed task could have
terminated either normally or by throwing an exception.
The results of this method are undefined if the given
collection is modified while this operation is in progress.
invokeAll in interface ExecutorServicetasks - the collection of tasks
InterruptedException - if interrupted while waiting, in
which case unfinished tasks are cancelled.
public <T> List<Future<T>> invokeAll(Collection<Callable<T>> tasks,
long timeout,
TimeUnit unit)
throws InterruptedException
ExecutorServiceFuture.isDone() is true for each
element of the returned list.
Upon return, tasks that have not completed are cancelled.
Note that a completed task could have
terminated either normally or by throwing an exception.
The results of this method are undefined if the given
collection is modified while this operation is in progress.
invokeAll in interface ExecutorServicetasks - the collection of taskstimeout - the maximum time to waitunit - the time unit of the timeout argument
InterruptedException - if interrupted while waiting, in
which case unfinished tasks are cancelled.
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.