net.tomp2p.dht

Class FutureGet

java.lang.Object

net.tomp2p.futures.BaseFutureImpl<K>

net.tomp2p.dht.FutureDHT<FutureGet>

net.tomp2p.dht.FutureGet

All Implemented Interfaces:

BaseFuture, Cancel

public class FutureGet
extends FutureDHT<FutureGet>

The future object for put() operations including routing.

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.dht.FutureDHT

futuresCompleted

Fields inherited from class net.tomp2p.futures.BaseFutureImpl

completed, lock, reason, type

Constructor Summary

Constructors

Constructor and Description
FutureGet(DHTBuilder<?> builder) Default constructor.
FutureGet(DHTBuilder<?> builder, int min, EvaluatingSchemeDHT evaluationScheme) Creates a new DHT future object that keeps track of the status of the DHT operations.

Method Summary

Methods

Modifier and Type	Method and Description
Data	data()
Map<Number640,Data>	dataMap() Return the data from get() after evaluation.
DigestResult	digest() Return the digest information from the get() after evaluation.
boolean	isEmpty()
boolean	isMinReached() Checks if the minimum of expected results have been reached.
Map<PeerAddress,Map<Number640,Data>>	rawData() Returns the raw data from the get operation.
Map<PeerAddress,DigestResult>	rawDigest()
Map<PeerAddress,Byte>	rawStatus()
void	receivedData(Map<PeerAddress,Map<Number640,Data>> rawData, Map<PeerAddress,DigestResult> rawDigest, Map<PeerAddress,Byte> rawStatus, FutureDone<Void> futuresCompleted) Finish the future and set the keys and data that have been received.

Methods inherited from class net.tomp2p.dht.FutureDHT

addFutureDHTReleaseListener, addRequests, builder, futureRequests, futureRouting, futureRouting, futuresCompleted

Methods inherited from class net.tomp2p.futures.BaseFutureImpl

addCancel, 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

FutureGet

public FutureGet(DHTBuilder<?> builder)

Default constructor.

FutureGet

public FutureGet(DHTBuilder<?> builder,
         int min,
         EvaluatingSchemeDHT evaluationScheme)

Creates a new DHT future object that keeps track of the status of the DHT operations.

Parameters:

min - The minimum of expected results

evaluationScheme - The scheme to evaluate results from multiple peers

Method Detail

receivedData

public void receivedData(Map<PeerAddress,Map<Number640,Data>> rawData,
                Map<PeerAddress,DigestResult> rawDigest,
                Map<PeerAddress,Byte> rawStatus,
                FutureDone<Void> futuresCompleted)

Finish the future and set the keys and data that have been received.

Parameters:

rawData - The keys and data that have been received with information from which peer it has been received.

rawDigest - The hashes of the content stored with information from which peer it has been received.

rawStatus -

futuresCompleted -

rawData

public Map<PeerAddress,Map<Number640,Data>> rawData()

Returns the raw data from the get operation.

Returns:

The raw data and the information which peer has been contacted

rawDigest

public Map<PeerAddress,DigestResult> rawDigest()

Returns:

The raw digest information with hashes of the content and the information which peer has been contacted

rawStatus

public Map<PeerAddress,Byte> rawStatus()

Returns:

The raw digest information with hashes of the content and the information which peer has been contacted

digest

public DigestResult digest()

Return the digest information from the get() after evaluation. The evaluation gets rid of the PeerAddress information, by either a majority vote or cumulation.

Returns:

The evaluated digest information that have been received.

dataMap

public Map<Number640,Data> dataMap()

Return the data from get() after evaluation. The evaluation gets rid of the PeerAddress information, by either a majority vote or cumulation.

Returns:

The evaluated data that have been received.

data

public Data data()

Returns:

The first data object from get() after evaluation.

isMinReached

public boolean isMinReached()

Checks if the minimum of expected results have been reached. This flag is also used for determining the success or failure of this future for put and send_direct.

Returns:

True, if expected minimum results have been reached.

isEmpty

public boolean isEmpty()