freenet.client.async

Class DefaultManifestPutter

java.lang.Object

freenet.client.async.ClientRequester

freenet.client.async.BaseClientPutter

freenet.client.async.ManifestPutter

freenet.client.async.BaseManifestPutter

freenet.client.async.DefaultManifestPutter

All Implemented Interfaces:

ClientRequestSchedulerGroup, java.io.Serializable

public class DefaultManifestPutter
extends BaseManifestPutter

The default manifest putter. It should be choosen if no alternative putter is given. Its also the replacment for SimpleManifestPutter, thats not longer simple!

default doc: defaultName is just the name, without any '/'!
each item is the default doc in the corresponding dir

pack limits:

• max container size: 2MB (a CHK manifest with 62 CHK redirects)
• max container item size: 1MB. Items >1MB are inserted as externals. exception: see rule 1)
• container size spare: 15KB. No crystal ball is perfect, so we have space for 'unexpected' metadata.

pack rules:

1. If all items fits into a container, they goes into container. Sample: A 1,6MB file and ten 3KB files goes into the same container
2. RTFS :P

pack hints for clients:
If the files in the site root directory fits into a container, they are in the root container (the first fetched container)
Save formula: (accumulated file size) + (512 Bytes * <subdircount>) < 1,8MB

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class freenet.client.async.BaseManifestPutter

BaseManifestPutter.ContainerBuilder, BaseManifestPutter.FreeFormBuilder, BaseManifestPutter.ManifestBuilder

Field Summary

Fields

Modifier and Type	Field and Description
static long	DEFAULT_CONTAINERSIZE_SPARE
static long	DEFAULT_MAX_CONTAINERITEMSIZE
static long	DEFAULT_MAX_CONTAINERSIZE

Fields inherited from class freenet.client.async.BaseManifestPutter

minSuccessFetchBlocks

Fields inherited from class freenet.client.async.ClientRequester

blockSetFinalized, cancelled, client, creationTime, failedBlocks, fatallyFailedBlocks, latestFailure, latestSuccess, minSuccessBlocks, priorityClass, realTimeFlag, sentToNetwork, successfulBlocks, totalBlocks

Constructor Summary

Constructors

Constructor and Description
DefaultManifestPutter(ClientPutCallback clientCallback, java.util.HashMap<java.lang.String,java.lang.Object> manifestElements, short prioClass, FreenetURI target, java.lang.String defaultName, InsertContext ctx, boolean persistent, byte[] forceCryptoKey, ClientContext context)

Method Summary

Modifier and Type	Method and Description
void	innerOnResume(ClientContext context) Called by onResume() once and only once after restarting.
protected void	makePutHandlers(java.util.HashMap<java.lang.String,java.lang.Object> manifestElements, java.lang.String defaultName) Implements the pack logic.

Methods inherited from class freenet.client.async.BaseManifestPutter

addBlock, addBlocks, addMustSucceedBlocks, addRedundantBlocksInsert, blockSetFinalized, bucketsByNameToManifestEntries, cancel, countFiles, flatten, flatten, getCallback, getMinSuccessFetchBlocks, getRootBuilder, getRootContainer, getSplitfileCryptoKey, getURI, guessMime, guessMime, innerNotifyClients, innerToNetwork, isFinished, makeArchive, onFetchable, onShutdown, onTransition, onTransition, start, totalSize

Methods inherited from class freenet.client.async.BaseClientPutter

dump

Methods inherited from class freenet.client.async.ClientRequester

cancel, clearCountersOnRestart, completedBlock, failedBlock, failedBlock, fatallyFailedBlock, getAll, getClient, getClientDetail, getClientDetail, getLatestFailure, getLatestSuccess, getPriorityClass, getSchedulerGroup, getTotalBlocks, hashCode, isCancelled, isCurrentState, notifyClients, onResume, persistent, realTimeFlag, resetBlocks, setPriorityClass, toNetwork

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_MAX_CONTAINERSIZE

public static final long DEFAULT_MAX_CONTAINERSIZE

See Also:

Constant Field Values

DEFAULT_MAX_CONTAINERITEMSIZE

public static final long DEFAULT_MAX_CONTAINERITEMSIZE

See Also:

Constant Field Values

DEFAULT_CONTAINERSIZE_SPARE

public static final long DEFAULT_CONTAINERSIZE_SPARE

See Also:

Constant Field Values

Constructor Detail

DefaultManifestPutter

public DefaultManifestPutter(ClientPutCallback clientCallback,
                             java.util.HashMap<java.lang.String,java.lang.Object> manifestElements,
                             short prioClass,
                             FreenetURI target,
                             java.lang.String defaultName,
                             InsertContext ctx,
                             boolean persistent,
                             byte[] forceCryptoKey,
                             ClientContext context)
                      throws TooManyFilesInsertException

Throws:

TooManyFilesInsertException

Method Detail

makePutHandlers

protected void makePutHandlers(java.util.HashMap<java.lang.String,java.lang.Object> manifestElements,
                               java.lang.String defaultName)
                        throws TooManyFilesInsertException

Implements the pack logic.

Specified by:

makePutHandlers in class BaseManifestPutter

Parameters:

manifestElements - A map from String to either ManifestElement or another String. This is the site structure, which will be split into containers and/or external inserts by the method.

Throws:

TooManyFilesInsertException

See Also:

BaseManifestPutter.makePutHandlers(java.util.HashMap, String)

innerOnResume

public void innerOnResume(ClientContext context)
                   throws ResumeFailedException

Description copied from class: ClientRequester

Called by onResume() once and only once after restarting. Must be overridden, and must call super.innerOnResume().

Overrides:

innerOnResume in class BaseManifestPutter

Throws:

ResumeFailedException