freenet.client.async

Class SingleFileFetcher

java.lang.Object

freenet.node.SendableRequest

freenet.node.BaseSendableGet

freenet.node.SendableGet

freenet.client.async.BaseSingleFileFetcher

freenet.client.async.SimpleSingleFileFetcher

freenet.client.async.SingleFileFetcher

All Implemented Interfaces:

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

public class SingleFileFetcher
extends SimpleSingleFileFetcher

Does most of the complicated metadata handling for fetching single files. WARNING: Changing non-transient members on classes that are Serializable can result in restarting downloads or losing uploads.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SingleFileFetcher.MyUSKFetcherCallback

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

Constructor Summary

Constructors

Constructor and Description
SingleFileFetcher(ClientRequester parent, GetCompletionCallback cb, ClientMetadata metadata, ClientKey key, java.util.List<java.lang.String> metaStrings, FreenetURI origURI, int addedMetaStrings, FetchContext ctx, boolean deleteFetchContext, boolean realTimeFlag, ArchiveContext actx, ArchiveHandler ah, Metadata archiveMetadata, int maxRetries, int recursionLevel, boolean dontTellClientGet, long l, boolean isEssential, boolean isFinal, boolean topDontCompress, short topCompatibilityMode, ClientContext context, boolean hasInitialMetadata) Create a new SingleFileFetcher and register self.
SingleFileFetcher(SingleFileFetcher fetcher, boolean persistent, boolean deleteFetchContext, Metadata newMeta, GetCompletionCallback callback, FetchContext ctx2, ClientContext context) Copy constructor, modifies a few given fields, don't call schedule().

Method Summary

Modifier and Type	Method and Description
static ClientGetState	create(ClientRequester requester, GetCompletionCallback cb, FreenetURI uri, FetchContext ctx, ArchiveContext actx, int maxRetries, int recursionLevel, boolean dontTellClientGet, long l, boolean isEssential, boolean isFinal, ClientContext context, boolean realTimeFlag, boolean hasInitialMetadata) Create a fetcher for a key.
protected void	innerWrapHandleMetadata(boolean notFinalizedSize, ClientContext context)
void	onSuccess(ClientKeyBlock block, boolean fromStore, java.lang.Object token, ClientContext context) Called when/if the low-level request succeeds.
protected void	onSuccess(FetchResult result, ClientContext context) Will be overridden by SingleFileFetcher

Methods inherited from class freenet.client.async.SimpleSingleFileFetcher

cancel, extract, getClientGetState, getToken, notFoundInStore, onBlockDecodeError, onFailure, onFailure, onShutdown

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

Constructor Detail

SingleFileFetcher

public SingleFileFetcher(ClientRequester parent,
                         GetCompletionCallback cb,
                         ClientMetadata metadata,
                         ClientKey key,
                         java.util.List<java.lang.String> metaStrings,
                         FreenetURI origURI,
                         int addedMetaStrings,
                         FetchContext ctx,
                         boolean deleteFetchContext,
                         boolean realTimeFlag,
                         ArchiveContext actx,
                         ArchiveHandler ah,
                         Metadata archiveMetadata,
                         int maxRetries,
                         int recursionLevel,
                         boolean dontTellClientGet,
                         long l,
                         boolean isEssential,
                         boolean isFinal,
                         boolean topDontCompress,
                         short topCompatibilityMode,
                         ClientContext context,
                         boolean hasInitialMetadata)
                  throws FetchException

Create a new SingleFileFetcher and register self. Called when following a redirect, or direct from ClientGet. FIXME: Many times where this is called internally we might be better off using a copy constructor?

Parameters:

topCompatibilityMode -

topDontCompress -

hasInitialMetadata -

Throws:

FetchException

SingleFileFetcher

public SingleFileFetcher(SingleFileFetcher fetcher,
                         boolean persistent,
                         boolean deleteFetchContext,
                         Metadata newMeta,
                         GetCompletionCallback callback,
                         FetchContext ctx2,
                         ClientContext context)
                  throws FetchException

Copy constructor, modifies a few given fields, don't call schedule(). Used for things like slave fetchers for MultiLevelMetadata, therefore does not remember returnBucket, metaStrings etc.

Throws:

FetchException

Method Detail

onSuccess

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

Description copied from class: BaseSingleFileFetcher

Called when/if the low-level request succeeds.

Overrides:

onSuccess in class SimpleSingleFileFetcher

onSuccess

protected void onSuccess(FetchResult result,
                         ClientContext context)

Description copied from class: SimpleSingleFileFetcher

Will be overridden by SingleFileFetcher

Overrides:

onSuccess in class SimpleSingleFileFetcher

innerWrapHandleMetadata

protected void innerWrapHandleMetadata(boolean notFinalizedSize,
                                       ClientContext context)

create

public static ClientGetState create(ClientRequester requester,
                                    GetCompletionCallback cb,
                                    FreenetURI uri,
                                    FetchContext ctx,
                                    ArchiveContext actx,
                                    int maxRetries,
                                    int recursionLevel,
                                    boolean dontTellClientGet,
                                    long l,
                                    boolean isEssential,
                                    boolean isFinal,
                                    ClientContext context,
                                    boolean realTimeFlag,
                                    boolean hasInitialMetadata)
                             throws java.net.MalformedURLException,
                                    FetchException

Create a fetcher for a key.

Throws:

java.net.MalformedURLException

FetchException