freenet.support

Class SentTimeCache

java.lang.Object

freenet.support.SentTimeCache

public class SentTimeCache
extends java.lang.Object

Keeps track of times at which sequence numbers were reported as sent, with bounded capacity. Cached times at which sent(int) was invoked are dropped on a first-in first-out basis.

Constructor Summary

Constructors

Constructor and Description
SentTimeCache(int maxSize) Constructs a sent time cache with the given maximal capacity.

Method Summary

Modifier and Type	Method and Description
long	queryAndRemove(int seqnum) Queries the sent time for the given sequence number and removes it from the cache.
void	report(int seqnum, long time) Reports the given sequence number as being sent at the given time.
void	sent(int seqnum) Convenience wrapper for report(int, long).

Methods inherited from class java.lang.Object

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

Constructor Detail

SentTimeCache

public SentTimeCache(int maxSize)

Constructs a sent time cache with the given maximal capacity.

Method Detail

report

public void report(int seqnum,
                   long time)

Reports the given sequence number as being sent at the given time. If the cache is at full capacity, this will lead to the oldest entry being dropped. If the sequence number was already in this cache, the given time will be associated with the sequence number, but the order in which sequence numbers are dropped from the cache will not be affected.

Parameters:

seqnum - the sequence number

time - the sent time in milliseconds

sent

public void sent(int seqnum)

Convenience wrapper for report(int, long). Reports the given sequence number as being sent right now. If the cache is at full capacity, this will lead to the oldest entry being dropped. If the sequence number was already in this cache, the current time will be associated with the sequence number, but the order in which sequence numbers are dropped from the cache will not be affected.

Parameters:

seqnum - the sequence number

See Also:

report(int, long)

queryAndRemove

public long queryAndRemove(int seqnum)

Queries the sent time for the given sequence number and removes it from the cache.

Parameters:

seqnum - the sequence number