freenet.client.async

Class SplitFileFetcherKeyListener

java.lang.Object

freenet.client.async.SplitFileFetcherKeyListener

All Implemented Interfaces:

KeyListener

public class SplitFileFetcherKeyListener
extends java.lang.Object
implements KeyListener

Constructor Summary

Constructors

Constructor and Description
SplitFileFetcherKeyListener(SplitFileFetcherStorageCallback fetcher, SplitFileFetcherStorage storage, boolean persistent, byte[] localSalt, int origSize, int segBlocks, int segments) Create a set of bloom filters for a new download.
SplitFileFetcherKeyListener(SplitFileFetcherStorage storage, SplitFileFetcherStorageCallback callback, java.io.DataInputStream dis, boolean persistent, boolean newSalt)

Method Summary

Modifier and Type	Method and Description
void	addedAllKeys()
long	countKeys()
short	definitelyWantKey(Key key, byte[] saltedKey, ClientContext context) Do we want the key? This is called by the ULPR code, because fetching the key will involve significant work.
HasKeyListener	getHasKeyListener()
short	getPriorityClass() Priority of the associated request.
SendableGet[]	getRequestsForKey(Key key, byte[] saltedKey, ClientContext context) Find the requests related to a specific key, used in retrying after cooldown.
boolean	handleBlock(Key key, byte[] saltedKey, KeyBlock block, ClientContext context) Handle the found data, if we really want it.
boolean	isEmpty() Has the request finished? If every key has been found, or enough keys have been found, return true so that the caller can remove it from the list.
boolean	isSSK()
boolean	needsKeys()
void	onRemove() Deactivate the request once it has been removed.
int	paddedMainBloomFilterSize()
boolean	persistent() Is this related to a persistent request?
boolean	probablyWantKey(Key key, byte[] saltedKey) Fast guess at whether we want a key or not.
void	writeStaticSettings(java.io.DataOutputStream dos)

Methods inherited from class java.lang.Object

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

Constructor Detail

SplitFileFetcherKeyListener

public SplitFileFetcherKeyListener(SplitFileFetcherStorageCallback fetcher,
                                   SplitFileFetcherStorage storage,
                                   boolean persistent,
                                   byte[] localSalt,
                                   int origSize,
                                   int segBlocks,
                                   int segments)
                            throws FetchException

Create a set of bloom filters for a new download.

Throws:

FetchException

SplitFileFetcherKeyListener

public SplitFileFetcherKeyListener(SplitFileFetcherStorage storage,
                                   SplitFileFetcherStorageCallback callback,
                                   java.io.DataInputStream dis,
                                   boolean persistent,
                                   boolean newSalt)
                            throws java.io.IOException,
                                   StorageFormatException

Throws:

java.io.IOException

StorageFormatException

Method Detail

paddedMainBloomFilterSize

public int paddedMainBloomFilterSize()

probablyWantKey

public boolean probablyWantKey(Key key,
                               byte[] saltedKey)

Description copied from interface: KeyListener

Fast guess at whether we want a key or not. Usually implemented by a bloom filter. LOCKING: Should avoid external locking if possible. Will be called within the CRSBase lock.

Specified by:

probablyWantKey in interface KeyListener

Returns:

True if we probably want the key. False if we definitely don't want it.

definitelyWantKey

public short definitelyWantKey(Key key,
                               byte[] saltedKey,
                               ClientContext context)

Description copied from interface: KeyListener

Do we want the key? This is called by the ULPR code, because fetching the key will involve significant work. tripPendingKey() on the other hand will go straight to handleBlock().

Specified by:

definitelyWantKey in interface KeyListener

Returns:

-1 if we don't want the key, otherwise the priority of the request interested in the key.

getRequestsForKey

public SendableGet[] getRequestsForKey(Key key,
                                       byte[] saltedKey,
                                       ClientContext context)

Description copied from interface: KeyListener

Find the requests related to a specific key, used in retrying after cooldown. Caller should call probablyWantKey() first.

Specified by:

getRequestsForKey in interface KeyListener

handleBlock

public boolean handleBlock(Key key,
                           byte[] saltedKey,
                           KeyBlock block,
                           ClientContext context)

Description copied from interface: KeyListener

Handle the found data, if we really want it.

Specified by:

handleBlock in interface KeyListener

persistent

public boolean persistent()

Description copied from interface: KeyListener

Is this related to a persistent request?

Specified by:

persistent in interface KeyListener

getPriorityClass

public short getPriorityClass()

Description copied from interface: KeyListener

Priority of the associated request. LOCKING: Should avoid external locking if possible. Will be called within the CRSBase lock.

Specified by:

getPriorityClass in interface KeyListener

countKeys

public long countKeys()

Specified by:

countKeys in interface KeyListener

getHasKeyListener

public HasKeyListener getHasKeyListener()

Specified by:

getHasKeyListener in interface KeyListener

Returns:

The parent HasKeyListener. This does mean it will be pinned in RAM, but it can be deactivated so it's not a big deal. LOCKING: Should avoid external locking if possible. Will be called within the CRSBase lock.

onRemove

public void onRemove()

Description copied from interface: KeyListener

Deactivate the request once it has been removed.

Specified by:

onRemove in interface KeyListener

isEmpty

public boolean isEmpty()

Description copied from interface: KeyListener

Has the request finished? If every key has been found, or enough keys have been found, return true so that the caller can remove it from the list.

Specified by:

isEmpty in interface KeyListener

isSSK

public boolean isSSK()

Specified by:

isSSK in interface KeyListener

writeStaticSettings

public void writeStaticSettings(java.io.DataOutputStream dos)
                         throws java.io.IOException

Throws:

java.io.IOException

needsKeys

public boolean needsKeys()

addedAllKeys

public void addedAllKeys()