freenet.client

Interface ArchiveHandler

public interface ArchiveHandler

Method Summary

Modifier and Type	Method and Description
ArchiveHandler	cloneHandler()
void	extractToCache(Bucket bucket, ArchiveContext actx, java.lang.String element, ArchiveExtractCallback callback, ArchiveManager manager, ClientContext context) Unpack a fetched archive to cache, and call the callback if there is one.
Bucket	get(java.lang.String internalName, ArchiveContext archiveContext, ArchiveManager manager) Get a file from this ZIP manifest, as a Bucket.
ArchiveManager.ARCHIVE_TYPE	getArchiveType() Get the archive type.
FreenetURI	getKey() Get the key.
Bucket	getMetadata(ArchiveContext archiveContext, ArchiveManager manager) Get the metadata for this ZIP manifest, as a Bucket.

Method Detail

getMetadata

Bucket getMetadata(ArchiveContext archiveContext,
                   ArchiveManager manager)
            throws ArchiveFailureException,
                   ArchiveRestartException,
                   MetadataParseException,
                   FetchException

Get the metadata for this ZIP manifest, as a Bucket. THE RETURNED BUCKET WILL ALWAYS BE NON-PERSISTENT.

Parameters:

manager - The ArchiveManager.

Returns:

The metadata as a Bucket, or null.

Throws:

FetchException - If the container could not be fetched.

MetadataParseException - If there was an error parsing intermediary metadata.

ArchiveFailureException

ArchiveRestartException

get

Bucket get(java.lang.String internalName,
           ArchiveContext archiveContext,
           ArchiveManager manager)
    throws ArchiveFailureException,
           ArchiveRestartException,
           MetadataParseException,
           FetchException

Get a file from this ZIP manifest, as a Bucket. If possible, read it from cache. If not, return null. THE RETURNED BUCKET WILL ALWAYS BE NON-PERSISTENT.

Parameters:

inSplitZipManifest - If true, indicates that the key points to a splitfile zip manifest, which means that we need to pass a flag to the fetcher to tell it to pretend it was a straight splitfile.

manager - The ArchiveManager.

Throws:

FetchException

MetadataParseException

ArchiveFailureException

ArchiveRestartException

getArchiveType

ArchiveManager.ARCHIVE_TYPE getArchiveType()

Get the archive type.

getKey

FreenetURI getKey()

Get the key.

extractToCache

void extractToCache(Bucket bucket,
                    ArchiveContext actx,
                    java.lang.String element,
                    ArchiveExtractCallback callback,
                    ArchiveManager manager,
                    ClientContext context)
             throws ArchiveFailureException,
                    ArchiveRestartException

Unpack a fetched archive to cache, and call the callback if there is one.

Parameters:

bucket - The downloaded data for the archive.

actx - The ArchiveContext.

element - The single element that the caller is especially interested in.

callback - Callback to be notified whether the content is available, and if so, fed the data.

manager - The ArchiveManager.

Throws:

ArchiveFailureException

ArchiveRestartException

cloneHandler

ArchiveHandler cloneHandler()