jadex.commons.future

Interface IFuture<E>

All Known Subinterfaces:

IIntermediateFuture<E>, ISubscriptionIntermediateFuture<E>, ITerminableFuture<E>, ITerminableIntermediateFuture<E>

All Known Implementing Classes:

Future, IntermediateFuture, SubscriptionIntermediateDelegationFuture, SubscriptionIntermediateFuture, TerminableDelegationFuture, TerminableFuture, TerminableIntermediateDelegationFuture, TerminableIntermediateFuture

public interface IFuture<E>

Interface for futures. Similar to Java Future interface but adds a listener notification mechanism.

Field Summary

Fields

Modifier and Type	Field and Description
static IFuture<Void>	DONE A future representing a completed action.

Method Summary

Methods

Modifier and Type	Method and Description
void	addResultListener(IResultListener<E> listener) Add a result listener.
E	get(ISuspendable caller) Get the result - blocking call.
E	get(ISuspendable caller, long timeout) Get the result - blocking call.
Exception	getException() Get the exception, if any.
boolean	isDone() Test if done, i.e. result is available.

Field Detail

DONE

static final IFuture<Void> DONE

A future representing a completed action. Can be used as direct return value of methods that do not perform asynchronous operations and do not return a result value.

Method Detail

isDone

boolean isDone()

Test if done, i.e. result is available.

Returns:

True, if done.

getException

Exception getException()

Get the exception, if any.

Returns:

The exception, if any, or null if the future is not yet done or succeeded without exception.

get

E get(ISuspendable caller)

Get the result - blocking call.

Returns:

The future result.

get

E get(ISuspendable caller,
    long timeout)

Get the result - blocking call.

Parameters:

timeout - The timeout in millis.

Returns:

The future result.

addResultListener

void addResultListener(IResultListener<E> listener)

Add a result listener.

Parameters:

listener - The listener.