net.tomp2p.futures

Class FutureTracker

java.lang.Object

net.tomp2p.futures.BaseFutureImpl<FutureTracker>

net.tomp2p.futures.FutureTracker

All Implemented Interfaces:

BaseFuture, Cancel

public class FutureTracker
extends BaseFutureImpl<FutureTracker>

This class holds the object for future results from the tracker get() and add(). FutureTracker can fail, if the search did not return any results.

Author:

Thomas Bocek

Nested Class Summary

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

BaseFuture.FutureType

Field Summary

Fields inherited from class net.tomp2p.futures.BaseFutureImpl

completed, lock, reason, type

Constructor Summary

Constructors

Constructor and Description
FutureTracker()
FutureTracker(EvaluatingSchemeTracker evaluatingSchemeTracker, Set<Number160> knownPeers) Create a future object for retrieving.
FutureTracker(FutureCreate<BaseFuture> futureCreate) Create a future object for storing

Method Summary

Methods

Modifier and Type	Method and Description
Set<PeerAddress>	directTrackers()
Set<Number160>	knownPeers()
Set<PeerAddress>	peersOnTracker()
Set<PeerAddress>	potentialTrackers()
Map<PeerAddress,TrackerData>	rawPeersOnTracker()
void	repeated(BaseFuture future) Called if a future is created based on this future.
Collection<TrackerData>	trackers() Evaluates the data from the trackers.
void	trackers(Set<PeerAddress> potentialTrackers, Set<PeerAddress> directTrackers, Map<PeerAddress,TrackerData> peersOnTracker) Set the result of the tracker process.

Methods inherited from class net.tomp2p.futures.BaseFutureImpl

addCancel, addListener, addListener, await, await, awaitListeners, awaitListenersUninterruptibly, awaitUninterruptibly, awaitUninterruptibly, cancel, completedAndNotify, failed, failed, failed, failed, failed, failedReason, isCompleted, isFailed, isSuccess, notifyListeners, removeCancel, removeListener, self, self, type

Methods inherited from class java.lang.Object

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

Constructor Detail

FutureTracker

public FutureTracker()

FutureTracker

public FutureTracker(FutureCreate<BaseFuture> futureCreate)

Create a future object for storing

Parameters:

futureCreate - Keeps track of futures that are based on this future

FutureTracker

public FutureTracker(EvaluatingSchemeTracker evaluatingSchemeTracker,
             Set<Number160> knownPeers)

Create a future object for retrieving.

Parameters:

evaluatingSchemeTracker - Since we receive results from multiple peers, we need to summarize them

knownPeers - A set of know peers that we don't want in the result set.

Method Detail

repeated

public void repeated(BaseFuture future)

Called if a future is created based on this future.

Parameters:

future - The newly created future

trackers

public void trackers(Set<PeerAddress> potentialTrackers,
            Set<PeerAddress> directTrackers,
            Map<PeerAddress,TrackerData> peersOnTracker)

Set the result of the tracker process.

Parameters:

potentialTrackers - The trackers that are close to the key, also containing the direct trackers.

directTrackers - Those peers that are close and reported to have the key.

peersOnTracker - The data from the trackers.

potentialTrackers

public Set<PeerAddress> potentialTrackers()

Returns:

The trackers that are close to the key, also containing the direct trackers.

directTrackers

public Set<PeerAddress> directTrackers()

Returns:

Those peers that are close and reported to have the key.

rawPeersOnTracker

public Map<PeerAddress,TrackerData> rawPeersOnTracker()

Returns:

the raw data, which means all the data the trackers reported.

peersOnTracker

public Set<PeerAddress> peersOnTracker()

Returns:

The peer address that send back data.

knownPeers

public Set<Number160> knownPeers()

Returns:

The list of peers which we already have in our result set.

trackers

public Collection<TrackerData> trackers()

Evaluates the data from the trackers. Since we receive multiple results, we evaluate them before we give the data to the user. If the user wants to see the raw data, use rawPeersOnTracker().

Returns:

The data from the trackers.