de.intarsys.tools.concurrent

Class AbstractFutureTask<R>

java.lang.Object

de.intarsys.tools.concurrent.AbstractFutureTask<R>

Type Parameters:

R -

All Implemented Interfaces:

Runnable, Future<R>

Direct Known Subclasses:

GenericFutureTask, TaskSequence, TaskStep

public abstract class AbstractFutureTask<R>
extends Object
implements Runnable, Future<R>

This is an alternate implementation for FutureTask, which is in some cases not flexible enough.

         +-------------+
         |             |       run
         | created     +------------------------------+
         |             |       #taskStarted           |
         +------+------+                              |
                |                                     |
                |                                     |
                |cancel                      +--------v----+
                |#taskCancelled              |             +-------------------+
                |                 +----------+ active      +----+              |
                |                 |          |             |    |              |
                |                 |cancel    +-------------+    |              |
                |                 |                             |              |
                |                 v                             |#taskFinished |#taskFailed
                |           +----------------+                  |#taskFinally  |#taskFinally
                |           |                |                  |              |
                |           | cancel pending |                  |              |
                |           |                |                  |              |
                |           +-----+----------+                  |              |
                |                 |                             v              |
                v                 |#undo                  +------------+  +----v-------+
         +--------------+         |#taskCancelled         |            |  |            |
         |              |         |                       | done       |  | failed     |
         | cancelled    |<--------+                       |            |  |            |
         |              |                                 +------------+  +------------+
         +--------------+
 

Method Summary

Methods

Modifier and Type	Method and Description
boolean	cancel(boolean interrupt)
R	get()
R	get(long timeout, TimeUnit unit) Wait for the result.
Throwable	getException()
String	getLabel()
ITaskListener	getTaskListener()
boolean	isActive()
boolean	isAsynch()
boolean	isCancelled()
boolean	isDone()
boolean	isFailed()
void	reset()
void	run()
void	runAsync()
void	setAsynch(boolean asynch)
void	setTaskListener(ITaskListener taskListener)
String	toString()

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

cancel

public boolean cancel(boolean interrupt)

Specified by:

cancel in interface Future<R>

get

public R get()
      throws InterruptedException,
             ExecutionException

Specified by:

get in interface Future<R>

Throws:

InterruptedException

ExecutionException

get

public R get(long timeout,
    TimeUnit unit)
      throws InterruptedException,
             ExecutionException,
             TimeoutException

Wait for the result. The "timeout" parameter allows to

• wait indefinite
when timeout == 0;
• wait specified duration
when timeout > 0;
• don't wait (peek)
when timeout < 0;

Specified by:

get in interface Future<R>

Throws:

InterruptedException

ExecutionException

TimeoutException

See Also:

Future.get(long, java.util.concurrent.TimeUnit)

getException

public Throwable getException()

getLabel

public String getLabel()

getTaskListener

public ITaskListener getTaskListener()

isActive

public boolean isActive()

isAsynch

public boolean isAsynch()

isCancelled

public boolean isCancelled()

Specified by:

isCancelled in interface Future<R>

isDone

public boolean isDone()

Specified by:

isDone in interface Future<R>

isFailed

public boolean isFailed()

reset

public void reset()

run

public final void run()

Specified by:

run in interface Runnable

runAsync

public final void runAsync()

setAsynch

public void setAsynch(boolean asynch)

setTaskListener

public void setTaskListener(ITaskListener taskListener)

toString

public String toString()

Overrides:

toString in class Object