| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public class FutureTask extends Object implements RunnableFuture
A cancellable asynchronous computation. This class provides a base implementation of {@link Future}, with methods to start and cancel a computation, query to see if the computation is complete, and retrieve the result of the computation. The result can only be retrieved when the computation has completed; the get method will block if the computation has not yet completed. Once the computation has completed, the computation cannot be restarted or cancelled.
A FutureTask can be used to wrap a {@link Callable} or {@link java.lang.Runnable} object. Because FutureTask implements Runnable, a FutureTask can be submitted to an {@link Executor} for execution.
In addition to serving as a standalone class, this class provides protected functionality that may be useful when creating customized task classes.
Constructor Summary | |
---|---|
FutureTask(Callable callable) Creates a FutureTask that will upon running, execute the given Callable. |
|
FutureTask(Runnable runnable, Object result) Creates a FutureTask that will upon running, execute the given Runnable, and arrange that get will return the given result on successful completion. |
Method Summary | |
---|---|
boolean |
cancel(boolean mayInterruptIfRunning) |
protected void |
done() Protected method invoked when this task transitions to state isDone (whether normally or via cancellation). |
Object |
get() |
Object |
|
boolean |
|
boolean |
isDone() |
void |
run() Sets this Future to the result of its computation unless it has been cancelled. |
protected boolean |
Executes the computation without setting its result, and then resets this Future to initial state, failing to do so if the computation encounters an exception or is cancelled. |
protected void |
Sets the result of this Future to the given value unless this future has already been set or has been cancelled. |
protected void |
Causes this future to report an ExecutionException with the given throwable as its cause, unless this Future has already been set or has been cancelled. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public FutureTask(Callable callable)
callable
- the callable taskpublic FutureTask(Runnable runnable, Object result)
runnable
- the runnable taskresult
- the result to return on successful completion. If
you don't need a particular result, consider using
constructions of the form:
Future<?> f = new FutureTask<Object>(runnable, null)Method Detail |
---|
public boolean cancel(boolean mayInterruptIfRunning)
mayInterruptIfRunning
protected void done()
public Object get() throws InterruptedException, ExecutionException
InterruptedException
ExecutionException
public Object get(long timeout, TimeUnit unit) throws InterruptedException, ExecutionException, TimeoutException
timeout
unit
InterruptedException
ExecutionException
TimeoutException
public boolean isCancelled()
public boolean isDone()
public void run()
protected boolean runAndReset()
protected void set(Object v)
v
- the valueprotected void setException(Throwable t)
t
- the cause of failure
| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |