net.tomp2p.peers

Class PeerStatistic

java.lang.Object

net.tomp2p.peers.PeerStatistic

All Implemented Interfaces:

Serializable

public class PeerStatistic
extends Object
implements Serializable

Keeps track of the statistics of a given peer.

Author:

Thomas Bocek

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	RTT_CACHE_SIZE

Constructor Summary

Constructors

Constructor and Description
PeerStatistic(PeerAddress peerAddress) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
PeerStatistic	addRTT(RTT rtt) Adds a RTT to the cache.
boolean	containsEstimates()
long	created()
boolean	equals(Object obj)
int	failed() Increases the failed counter.
RTT	getLatestRTT()
long	getMeanRTT() Get the mean of the last 5 RTTs
long	getNumberOfResponses()
int	getRTTCount() How many RTT measurements are in the cache
int	hashCode()
void	increaseNumberOfResponses()
boolean	isLocal()
long	lastSeenOnline()
PeerStatistic	local()
int	onlineTime()
PeerAddress	peerAddress()
PeerAddress	peerAddress(PeerAddress peerAddress) Set the peer address only if the previous peer address that had the same peer ID.
PeerStatistic	setLocal(boolean local)
int	successfullyChecked() Sets the time when last seen online to now.
int	successfullyCheckedCounter()

Methods inherited from class java.lang.Object

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

Field Detail

RTT_CACHE_SIZE

public static final int RTT_CACHE_SIZE

See Also:

Constant Field Values

Constructor Detail

PeerStatistic

public PeerStatistic(PeerAddress peerAddress)

Constructor. Sets the peer address

Parameters:

peerAddress - The peer address that belongs to this statistics

Method Detail

successfullyChecked

public int successfullyChecked()

Sets the time when last seen online to now.

Returns:

The number of successful checks

lastSeenOnline

public long lastSeenOnline()

Returns:

The time last seen online

successfullyCheckedCounter

public int successfullyCheckedCounter()

Returns:

The number of times the peer has been successfully checked

failed

public int failed()

Increases the failed counter.

Returns:

The number of failed checks.

created

public long created()

Returns:

The time of creating this peer (statistic)

onlineTime

public int onlineTime()

Returns:

The time that this peer is online

getNumberOfResponses

public long getNumberOfResponses()

increaseNumberOfResponses

public void increaseNumberOfResponses()

peerAddress

public PeerAddress peerAddress()

Returns:

the peer address associated with this peer address

peerAddress

public PeerAddress peerAddress(PeerAddress peerAddress)

Set the peer address only if the previous peer address that had the same peer ID.

Parameters:

peerAddress - The updated peer ID

Returns:

The old peer address

local

public PeerStatistic local()

isLocal

public boolean isLocal()

setLocal

public PeerStatistic setLocal(boolean local)

addRTT

public PeerStatistic addRTT(RTT rtt)

Adds a RTT to the cache. If the provided RTT object is an estimate it will be ignored in case there are already first-hand measurements in the cache. Also any real measurement will clear out any estimates in the cache beforehand. This prevents any mix-up between real measurements and estimates

Parameters:

rtt - The RTT object that should be added

Returns:

The PeerStatistic object

containsEstimates

public boolean containsEstimates()

Returns:

True, if the RTT cache contains estimates, false if empty or cache is empty.

getLatestRTT

public RTT getLatestRTT()

Returns:

Most recent RTT or null if cache is empty

getMeanRTT

public long getMeanRTT()

Get the mean of the last 5 RTTs

Returns:

Average RTT in milliseconds or -1 if cache is empty.

getRTTCount

public int getRTTCount()

How many RTT measurements are in the cache

Returns:

Number of RTT objects in cache. Number between 0 and RTT_CACHE_SIZE

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object