freenet.client.async

Class SimpleSingleFileFetcher

java.lang.Object

freenet.node.SendableRequest

freenet.node.BaseSendableGet

freenet.node.SendableGet

freenet.client.async.BaseSingleFileFetcher

freenet.client.async.SimpleSingleFileFetcher

All Implemented Interfaces:

ClientGetState, HasKeyListener, RequestSelectionTreeNode, RandomGrabArrayItem, java.io.Serializable

Direct Known Subclasses:

SingleFileFetcher

public class SimpleSingleFileFetcher
extends BaseSingleFileFetcher
implements ClientGetState, java.io.Serializable

Fetch a single block file. Used directly for very simple fetches, but also base class for SingleFileFetcher. WARNING: Changing non-transient members on classes that are Serializable can result in restarting downloads or losing uploads.

See Also:

Serialized Form

Field Summary

Fields inherited from class freenet.client.async.BaseSingleFileFetcher

cancelled, cooldownWakeupTime, ctx, deleteFetchContext, finished, key

Fields inherited from class freenet.node.SendableGet

parent

Fields inherited from class freenet.node.SendableRequest

parentGrabArray, persistent, realTimeFlag

Method Summary

Modifier and Type	Method and Description
void	cancel(ClientContext context) Cancel the request, and call onFailure() on the callback in order to tell downstream (ultimately the client) that cancel has succeeded, and to allow it to call removeFrom() to avoid a database leak.
protected Bucket	extract(ClientKeyBlock block, ClientContext context) Convert a ClientKeyBlock to a Bucket.
protected ClientGetState	getClientGetState()
long	getToken() getToken() is not supported
protected void	notFoundInStore(ClientContext context)
protected void	onBlockDecodeError(SendableRequestItem token, ClientContext context)
protected void	onFailure(FetchException e, boolean forceFatal, ClientContext context)
void	onFailure(LowLevelGetException e, SendableRequestItem reqTokenIgnored, ClientContext context) Called when/if the low-level request fails.
void	onShutdown(ClientContext context) Called just before the final write of client.dat before the node shuts down.
void	onSuccess(ClientKeyBlock block, boolean fromStore, java.lang.Object reqTokenIgnored, ClientContext context) Called when/if the low-level request succeeds.
protected void	onSuccess(FetchResult data, ClientContext context) Will be overridden by SingleFileFetcher

Methods inherited from class freenet.client.async.BaseSingleFileFetcher

chooseKey, countAllKeys, countSendableKeys, getClient, getClientRequest, getContext, getCooldownWakeup, getKey, getPriorityClass, getRequest, getWakeupTime, isCancelled, isEmpty, isSSK, listKeys, makeKeyListener, onChangedFetchContext, onEnterFiniteCooldown, onGotKey, onResume, onSuccess, preRegister, reschedule, retry, schedule, unregister, unregisterAll

Methods inherited from class freenet.node.SendableGet

clearWakeupTime, getNodeKey, getScheduler, getSender, internalError, isInsert, reduceWakeupTime, translateException

Methods inherited from class freenet.node.SendableRequest

getParentGrabArray, getSchedulerGroup, hashCode, knowsParentGrabArray, objectToString, persistent, realTimeFlag, setParentGrabArray

Methods inherited from class java.lang.Object

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

Methods inherited from interface freenet.client.async.ClientGetState

onResume, schedule

Method Detail

onFailure

public void onFailure(LowLevelGetException e,
                      SendableRequestItem reqTokenIgnored,
                      ClientContext context)

Description copied from class: SendableGet

Called when/if the low-level request fails.

Specified by:

onFailure in class SendableGet

onFailure

protected void onFailure(FetchException e,
                         boolean forceFatal,
                         ClientContext context)

onSuccess

protected void onSuccess(FetchResult data,
                         ClientContext context)

Will be overridden by SingleFileFetcher

onSuccess

public void onSuccess(ClientKeyBlock block,
                      boolean fromStore,
                      java.lang.Object reqTokenIgnored,
                      ClientContext context)

Description copied from class: BaseSingleFileFetcher

Called when/if the low-level request succeeds.

Specified by:

onSuccess in class BaseSingleFileFetcher

extract

protected Bucket extract(ClientKeyBlock block,
                         ClientContext context)

Convert a ClientKeyBlock to a Bucket. If an error occurs, report it via onFailure and return null.

getToken

public long getToken()

getToken() is not supported

Specified by:

getToken in interface ClientGetState

cancel

public void cancel(ClientContext context)

Description copied from interface: ClientGetState

Cancel the request, and call onFailure() on the callback in order to tell downstream (ultimately the client) that cancel has succeeded, and to allow it to call removeFrom() to avoid a database leak.

Specified by:

cancel in interface ClientGetState

Overrides:

cancel in class BaseSingleFileFetcher

notFoundInStore

protected void notFoundInStore(ClientContext context)

Specified by:

notFoundInStore in class BaseSingleFileFetcher

onBlockDecodeError

protected void onBlockDecodeError(SendableRequestItem token,
                                  ClientContext context)

Specified by:

onBlockDecodeError in class BaseSingleFileFetcher

onShutdown

public void onShutdown(ClientContext context)

Description copied from interface: ClientGetState

Called just before the final write of client.dat before the node shuts down. Should write any dirty data to disk etc.

Specified by:

onShutdown in interface ClientGetState

getClientGetState

protected ClientGetState getClientGetState()

Specified by:

getClientGetState in class SendableGet