freenet.client.async

Class CooldownBlockChooser

java.lang.Object

freenet.client.async.SimpleBlockChooser

freenet.client.async.CooldownBlockChooser

Direct Known Subclasses:

SplitFileFetcherSegmentBlockChooser

public class CooldownBlockChooser
extends SimpleBlockChooser

A block chooser including support for cooldown

Field Summary

Fields inherited from class freenet.client.async.SimpleBlockChooser

maxRetries

Constructor Summary

Constructors

Constructor and Description
CooldownBlockChooser(int blocks, java.util.Random random, int maxRetries, int cooldownTries, long cooldownTime)

Method Summary

Modifier and Type	Method and Description
protected boolean	checkValid(int blockNo) Is the proposed block valid? Override to implement custom logic e.g.
int	chooseKey() Choose a key to fetch, taking into account retries
void	clearCooldown() Should be called e.g.
long	getCooldownTime(int blockNumber)
protected int	innerOnNonFatalFailure(int blockNo) Notify when a block has failed.
void	onUnSuccess(int blockNo) Notify that a block has no longer succeeded.
long	overallCooldownTime()

Methods inherited from class freenet.client.async.SimpleBlockChooser

copyDownloadedBlocks, countFailedBlocks, countFetchable, getBlockNumber, getMaxBlockNumber, getRetries, hasSucceeded, hasSucceededAll, onCompletedAll, onNonFatalFailure, onSuccess, read, readRetries, replaceSuccesses, successCount, write, writeRetries

Methods inherited from class java.lang.Object

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

Constructor Detail

CooldownBlockChooser

public CooldownBlockChooser(int blocks,
                            java.util.Random random,
                            int maxRetries,
                            int cooldownTries,
                            long cooldownTime)

Method Detail

chooseKey

public int chooseKey()

Description copied from class: SimpleBlockChooser

Choose a key to fetch, taking into account retries

Overrides:

chooseKey in class SimpleBlockChooser

checkValid

protected boolean checkValid(int blockNo)

Description copied from class: SimpleBlockChooser

Is the proposed block valid? Override to implement custom logic e.g. checking which requests are already running.

Overrides:

checkValid in class SimpleBlockChooser

innerOnNonFatalFailure

protected int innerOnNonFatalFailure(int blockNo)

Description copied from class: SimpleBlockChooser

Notify when a block has failed.

Overrides:

innerOnNonFatalFailure in class SimpleBlockChooser

Returns:

The total number of attempts for the block so far. Some callers (e.g. inserter) may fail after a single terminal failure, others after some number of failures (e.g. getter), so we leave this to the caller.

clearCooldown

public final void clearCooldown()

Should be called e.g. when getMaxBlockNumber() changes.

onUnSuccess

public void onUnSuccess(int blockNo)

Description copied from class: SimpleBlockChooser

Notify that a block has no longer succeeded. E.g. we downloaded it but now the data is no longer available due to disk corruption.

Overrides:

onUnSuccess in class SimpleBlockChooser

overallCooldownTime

public long overallCooldownTime()

getCooldownTime

public long getCooldownTime(int blockNumber)