jadex.commons.future

Class Tuple2Future<E,F>

java.lang.Object

jadex.commons.future.Future<Collection<E>>

jadex.commons.future.IntermediateFuture<TupleResult>

jadex.commons.future.Tuple2Future<E,F>

All Implemented Interfaces:

IForwardCommandFuture, IFuture<Collection<TupleResult>>, IIntermediateFuture<TupleResult>, ITuple2Future<E,F>

public class Tuple2Future<E,F>
extends IntermediateFuture<TupleResult>
implements ITuple2Future<E,F>

Implementation of tuple2 future. The future is considered as finished when all tuple elements have been set.

Nested Class Summary

Nested classes/interfaces inherited from interface jadex.commons.future.IForwardCommandFuture

IForwardCommandFuture.Type

Field Summary

Fields inherited from class jadex.commons.future.Future

DEBUG, EMPTY, NO_STACK_COMPACTION, STACK

Fields inherited from interface jadex.commons.future.IIntermediateFuture

DONE

Constructor Summary

Constructors

Constructor and Description
Tuple2Future() Create a future that is already done.
Tuple2Future(E result1, F result2) Create a future that is already done.
Tuple2Future(Exception exception) Create a future that is already done (failed).

Method Summary

Modifier and Type	Method and Description
void	addTuple2ResultListener(IFunctionalResultListener<E> firstListener, IFunctionalResultListener<F> secondListener) Uses two functional result listeners to create a Tuple2ResultListener and add it.
void	addTuple2ResultListener(IFunctionalResultListener<E> firstListener, IFunctionalResultListener<F> secondListener, IFunctionalExceptionListener exceptionListener) Uses two functional result listeners to create a Tuple2ResultListener and add it.
E	getFirstResult() Get the first result.
E	getFirstResult(ISuspendable caller) Get the first result.
F	getSecondResult() Get the second result.
F	getSecondResult(ISuspendable caller) Get the second result.
void	setFirstResult(E result) Set the result.
void	setFirstResultIfUndone(E result) Set the result.
void	setSecondResult(F result) Set the result.
void	setSecondResultIfUndone(F result) Set the result.

Methods inherited from class jadex.commons.future.IntermediateFuture

addIntermediateResult, addIntermediateResultIfUndone, addIntermediateResultListener, addIntermediateResultListener, addIntermediateResultListener, addIntermediateResultListener, addResultListener, getIntermediateResults, getNextIntermediateResult, getNextIntermediateResult, hasNextIntermediateResult, setFinished, setFinishedIfUndone, setResult, setResultIfUndone

Methods inherited from class jadex.commons.future.Future

abortGet, addForwardCommand, addResultListener, addResultListener, get, get, get, get, getEmptyFuture, getException, isDone, removeForwardCommand, sendForwardCommand, setException, setExceptionIfUndone

Methods inherited from class java.lang.Object

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

Methods inherited from interface jadex.commons.future.IIntermediateFuture

addIntermediateResultListener, addIntermediateResultListener, addIntermediateResultListener, addIntermediateResultListener, getIntermediateResults, getNextIntermediateResult, hasNextIntermediateResult

Methods inherited from interface jadex.commons.future.IFuture

addResultListener, addResultListener, addResultListener, get, get, get, get, getException, isDone

Constructor Detail

Tuple2Future

public Tuple2Future()

Create a future that is already done.

Parameters:

result - The result, if any.

Tuple2Future

public Tuple2Future(E result1,
                    F result2)

Create a future that is already done.

Parameters:

result - The result, if any.

Tuple2Future

public Tuple2Future(Exception exception)

Create a future that is already done (failed).

Parameters:

exception - The exception.

Method Detail

getFirstResult

public E getFirstResult()

Get the first result.

Specified by:

getFirstResult in interface ITuple2Future<E,F>

Returns:

The next intermediate result.

Throws:

NoSuchElementException, - when there are no more intermediate results and the future is finished.

getFirstResult

public E getFirstResult(ISuspendable caller)

Get the first result.

Specified by:

getFirstResult in interface ITuple2Future<E,F>

Returns:

The next intermediate result.

Throws:

NoSuchElementException, - when there are no more intermediate results and the future is finished.

getSecondResult

public F getSecondResult()

Get the second result.

Specified by:

getSecondResult in interface ITuple2Future<E,F>

Returns:

The next intermediate result.

Throws:

NoSuchElementException, - when there are no more intermediate results and the future is finished.

getSecondResult

public F getSecondResult(ISuspendable caller)

Get the second result.

Specified by:

getSecondResult in interface ITuple2Future<E,F>

Returns:

The next intermediate result.

Throws:

NoSuchElementException, - when there are no more intermediate results and the future is finished.

setFirstResult

public void setFirstResult(E result)

Set the result. Listener notifications occur on calling thread of this method.

Parameters:

result - The result.

setSecondResult

public void setSecondResult(F result)

Set the result. Listener notifications occur on calling thread of this method.

Parameters:

result - The result.

setFirstResultIfUndone

public void setFirstResultIfUndone(E result)

Set the result. Listener notifications occur on calling thread of this method.

Parameters:

result - The result.

addTuple2ResultListener

public void addTuple2ResultListener(IFunctionalResultListener<E> firstListener,
                                    IFunctionalResultListener<F> secondListener)

Uses two functional result listeners to create a Tuple2ResultListener and add it. The first listener is called upon reception of the first result, the second is called for the second result. Exceptions will be logged to console.

Specified by:

addTuple2ResultListener in interface ITuple2Future<E,F>

Parameters:

firstListener - Listener for the first available result.

secondListener - Listener for the second available result.

addTuple2ResultListener

public void addTuple2ResultListener(IFunctionalResultListener<E> firstListener,
                                    IFunctionalResultListener<F> secondListener,
                                    IFunctionalExceptionListener exceptionListener)

Uses two functional result listeners to create a Tuple2ResultListener and add it. The first listener is called upon reception of the first result, the second is called for the second result. Additionally, a given exception listener is called when exceptions occur.

Specified by:

addTuple2ResultListener in interface ITuple2Future<E,F>

Parameters:

firstListener - Listener for the first available result.

secondListener - Listener for the second available result.

exListener - The listener that is called on exceptions. Passing null enables default exception logging.

setSecondResultIfUndone

public void setSecondResultIfUndone(F result)

Set the result. Listener notifications occur on calling thread of this method.

Parameters:

result - The result.