net.tomp2p.futures

Class BaseFutureImpl<K extends BaseFuture>

java.lang.Object

net.tomp2p.futures.BaseFutureImpl<K>

Type Parameters:

K - The class that extends BaseFuture and is used to return back the type for method calls. E.g, if K is FutureDHT await() returns FutureDHT.

All Implemented Interfaces:

BaseFuture, Cancel

Direct Known Subclasses:

FutureAnnounce, FutureAsyncTask, FutureChannelCreator, FutureDiscover, FutureDone, FutureForkJoin, FutureLateJoin, FutureLaterJoin, FuturePing, FutureProgres, FutureResponse, FutureRouting, FutureTask, FutureWrapper, FutureWrapper2

public abstract class BaseFutureImpl<K extends BaseFuture>
extends Object
implements BaseFuture

The base for all BaseFuture implementations. Be aware of possible deadlocks. Never await from a listener. This class is heavily inspired by MINA and Netty.

Author:

Thomas Bocek

Nested Class Summary

Nested classes/interfaces inherited from interface net.tomp2p.futures.BaseFuture

BaseFuture.FutureType

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	completed
protected Object	lock
protected String	reason
protected BaseFuture.FutureType	type

Constructor Summary

Constructors

Constructor and Description
BaseFutureImpl() Default constructor that sets the lock object, which is used for synchronization to this instance.

Method Summary

Methods

Modifier and Type	Method and Description
K	addCancel(Cancel cancelListener) Adds a cancel listener to this future, which is called when cancel is executed.
K	addListener(BaseFutureListener<? extends BaseFuture> listener) Adds a listener which is notified when the state of this future changes.
K	addListener(BaseFutureListener<? extends BaseFuture> listener, boolean last) Adds a listener which is notified when the state of this future changes.
K	await() Wait for the asynchronous operation to end.
boolean	await(long timeoutMillis) Wait for the asynchronous operation to end with the specified timeout.
K	awaitListeners() Waits until all the listener finished.
K	awaitListenersUninterruptibly() Waits uninterruptedly until all the listener finished.
K	awaitUninterruptibly() Wait for the asynchronous operation to end without interruption.
boolean	awaitUninterruptibly(long timeoutMillis) Wait for the asynchronous operation to end with the specified timeout without interruption.
void	cancel() This method gets called if a future is cancelled.
protected boolean	completedAndNotify() Make sure that the calling method has synchronized (lock).
K	failed(BaseFuture origin) Sets the failed flag to true and the completed flag to true.
K	failed(String failed) Sets the failed flag to true and the completed flag to true.
K	failed(String failed, BaseFuture origin) Sets the failed flag to true and the completed flag to true.
K	failed(String failed, Throwable t) Sets the failed flag to true and the completed flag to true.
K	failed(Throwable t) Sets the failed flag to true and the completed flag to true.
String	failedReason() The default failed reason is Unknown.
boolean	isCompleted() Checks if the asynchronous operation is finished.
boolean	isFailed() Checks if operation has failed.
boolean	isSuccess() Returns the opposite of isFailed (returns !isFailed).
protected void	notifyListeners() Always call this from outside synchronized(lock)!
K	removeCancel(Cancel cancelListener) Removes a cancel listener to this future.
K	removeListener(BaseFutureListener<? extends BaseFuture> listener) Removes a listener which is notified when the state of this future changes.
protected K	self()
protected void	self(K self2)
BaseFuture.FutureType	type() If the type is not OK, then something unexpected happened.

Methods inherited from class java.lang.Object

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

Field Detail

lock

protected final Object lock

completed

protected boolean completed

type

protected BaseFuture.FutureType type

reason

protected String reason

Constructor Detail

BaseFutureImpl

public BaseFutureImpl()

Default constructor that sets the lock object, which is used for synchronization to this instance.

Method Detail

self

protected void self(K self2)

Parameters:

self2 - Set the type so that we are able to return it to the user. This is for making the API much more usable.

self

protected K self()

Returns:

The object that stored this object. This is necessary for the builder pattern when using generics.

await

public K await()
                           throws InterruptedException

Description copied from interface: BaseFuture

Wait for the asynchronous operation to end.

Specified by:

await in interface BaseFuture

Returns:

this

Throws:

InterruptedException - if thread is interrupted

awaitUninterruptibly

public K awaitUninterruptibly()

Description copied from interface: BaseFuture

Wait for the asynchronous operation to end without interruption.

Specified by:

awaitUninterruptibly in interface BaseFuture

Returns:

this

await

public boolean await(long timeoutMillis)
              throws InterruptedException

Description copied from interface: BaseFuture

Wait for the asynchronous operation to end with the specified timeout.

Specified by:

await in interface BaseFuture

Parameters:

timeoutMillis - time to wait at most

Returns:

true if the operation is finished.

Throws:

InterruptedException - if thread is interrupted

awaitUninterruptibly

public boolean awaitUninterruptibly(long timeoutMillis)

Description copied from interface: BaseFuture

Wait for the asynchronous operation to end with the specified timeout without interruption.

Specified by:

awaitUninterruptibly in interface BaseFuture

Parameters:

timeoutMillis - to wait at most

Returns:

true if the operation is finished.

isCompleted

public boolean isCompleted()

Description copied from interface: BaseFuture

Checks if the asynchronous operation is finished.

Specified by:

isCompleted in interface BaseFuture

Returns:

true if operation is finished

isSuccess

public boolean isSuccess()

Description copied from interface: BaseFuture

Returns the opposite of isFailed (returns !isFailed). Use this method if you are an optimist ;) otherwise use isFailed

Specified by:

isSuccess in interface BaseFuture

Returns:

true if operation succeeded, false if there was no reply

isFailed

public boolean isFailed()

Description copied from interface: BaseFuture

Checks if operation has failed. As this is a P2P network, where peers can fail at any time, a failure is seen as a "normal" event. Thus, no exception is thrown.

Specified by:

isFailed in interface BaseFuture

Returns:

true if operation failed, which means the node did not reply. A get(key) operation on a node that does not have the key, returns false with this method as a response has been send.

failed

public K failed(BaseFuture origin)

Description copied from interface: BaseFuture

Sets the failed flag to true and the completed flag to true. This will notify listeners and set the reason based on the origin BaseFuture.

Specified by:

failed in interface BaseFuture

Parameters:

origin - The origin of failure

Returns:

this

failed

public K failed(String failed,
       BaseFuture origin)

Description copied from interface: BaseFuture

Sets the failed flag to true and the completed flag to true. This will notify listeners and append the reason based on the origin BaseFuture.

Specified by:

failed in interface BaseFuture

Parameters:

failed - The reason of failure

origin - The origin of failure

Returns:

this

failed

public K failed(Throwable t)

Description copied from interface: BaseFuture

Sets the failed flag to true and the completed flag to true. This will notify listeners and append the reason based on the origin BaseFuture.

Specified by:

failed in interface BaseFuture

Parameters:

t - The stack trace where the failure happened

Returns:

this

failed

public K failed(String failed,
       Throwable t)

Description copied from interface: BaseFuture

Sets the failed flag to true and the completed flag to true. This will notify listeners and append the reason based on the origin BaseFuture.

Specified by:

failed in interface BaseFuture

Parameters:

failed - The reason of failure

t - The stack trace where the failure happened

Returns:

this

failed

public K failed(String failed)

Description copied from interface: BaseFuture

Sets the failed flag to true and the completed flag to true. This will notify listeners and set the reason

Specified by:

failed in interface BaseFuture

Parameters:

failed - The reason of failure

Returns:

this

failedReason

public String failedReason()

Description copied from interface: BaseFuture

The default failed reason is Unknown.

Specified by:

failedReason in interface BaseFuture

Returns:

Returns the reason why a future failed.

type

public BaseFuture.FutureType type()

Description copied from interface: BaseFuture

If the type is not OK, then something unexpected happened.

Specified by:

type in interface BaseFuture

Returns:

The type

completedAndNotify

protected boolean completedAndNotify()

Make sure that the calling method has synchronized (lock).

Returns:

True if notified. It will notify if completed is not set yet.

awaitListeners

public K awaitListeners()
                                    throws InterruptedException

Description copied from interface: BaseFuture

Waits until all the listener finished. This may include the release of resources.

Specified by:

awaitListeners in interface BaseFuture

Returns:

this

Throws:

InterruptedException - If interrupted from outside

awaitListenersUninterruptibly

public K awaitListenersUninterruptibly()

Description copied from interface: BaseFuture

Waits uninterruptedly until all the listener finished. This may include the release of resources.

Specified by:

awaitListenersUninterruptibly in interface BaseFuture

Returns:

this

addListener

public K addListener(BaseFutureListener<? extends BaseFuture> listener)

Description copied from interface: BaseFuture

Adds a listener which is notified when the state of this future changes. All notifications are performed in a thread, which means that this method returns immediately. If a future is complete, then all listeners are called and after that, the listener list is cleared, so there is no need to call removeListener if a future has been completed.

Specified by:

addListener in interface BaseFuture

Parameters:

listener - The listener extends the BaseFuture

Returns:

this

addListener

public K addListener(BaseFutureListener<? extends BaseFuture> listener,
            boolean last)

Description copied from interface: BaseFuture

Adds a listener which is notified when the state of this future changes. All notifications are performed in a thread, which means that this method returns immediately. If a future is complete, then all listeners are called and after that, the listener list is cleared, so there is no need to call removeListener if a future has been completed. A flag decides if the listener is added at the end of the list or at the beginning.

Specified by:

addListener in interface BaseFuture

Parameters:

listener - The listener extends the BaseFuture

last - Set to true if the listener should be added at the end of the list, true if it should be added first

Returns:

this

notifyListeners

protected void notifyListeners()

Always call this from outside synchronized(lock)!

removeListener

public K removeListener(BaseFutureListener<? extends BaseFuture> listener)

Description copied from interface: BaseFuture

Removes a listener which is notified when the state of this future changes. If a future is complete, then all listeners are called and after that, the listener list is cleared, so there is no need to call removeListener if a future has been completed. The listener can be called from the caller thread if the future is already finished or from a different thread if the future is not ready yet.

Specified by:

removeListener in interface BaseFuture

Parameters:

listener - The listener extends the BaseFuture

Returns:

this

addCancel

public K addCancel(Cancel cancelListener)

Description copied from interface: BaseFuture

Adds a cancel listener to this future, which is called when cancel is executed. Triggering a cancel does not finish this future.

Specified by:

addCancel in interface BaseFuture

Parameters:

cancelListener - The cancel listener

Returns:

this

removeCancel

public K removeCancel(Cancel cancelListener)

Description copied from interface: BaseFuture

Removes a cancel listener to this future. Triggering a cancel does not finish this future.

Specified by:

removeCancel in interface BaseFuture

Parameters:

cancelListener - The cancel listener

Returns:

This class

cancel

public void cancel()

Description copied from interface: Cancel

This method gets called if a future is cancelled.

Specified by:

cancel in interface Cancel