de.schlichtherle.io.archive.zip
Class ZipInputArchive

java.lang.Object
  de.schlichtherle.util.zip.BasicZipFile
      de.schlichtherle.io.archive.zip.ZipInputArchive

All Implemented Interfaces:

InputArchive

Direct Known Subclasses:

CheckedZipInputArchive, JarInputArchive, Zip32InputArchive

public class ZipInputArchive
extends BasicZipFile
implements InputArchive

An implementation of InputArchive to read ZIP archives.

Since:

TrueZIP 6.7

Author:

Christian Schlichtherle

See Also:

ZipDriver

metaData

private InputArchiveMetaData metaData

ZipInputArchive

public ZipInputArchive(ReadOnlyFile rof,
                       String charset,
                       boolean preambled,
                       boolean postambled)
                throws NullPointerException,
                       UnsupportedEncodingException,
                       FileNotFoundException,
                       ZipException,
                       IOException

Throws:

NullPointerException

UnsupportedEncodingException

FileNotFoundException

ZipException

IOException

createZipEntry

protected ZipEntry createZipEntry(String entryName)

Description copied from class: BasicZipFile

A factory method returning a newly created ZipEntry for the given name.

Overrides:

createZipEntry in class BasicZipFile

getNumArchiveEntries

public int getNumArchiveEntries()

Description copied from interface: InputArchive

Returns the number of ArchiveEntry instances in this archive.

Specified by:

getNumArchiveEntries in interface InputArchive

getArchiveEntries

public Enumeration getArchiveEntries()

Description copied from interface: InputArchive

Returns an enumeration of the ArchiveEntry instances in this archive.

Specified by:

getArchiveEntries in interface InputArchive

getArchiveEntry

public ArchiveEntry getArchiveEntry(String entryName)

Description copied from interface: InputArchive

Returns the ArchiveEntry for the given entry name or null if no entry with this name exists.

Specified by:

getArchiveEntry in interface InputArchive

Parameters:

entryName - A valid archive entry name - never null.

See Also:

Requirements for Archive Entry Names

getInputStream

public InputStream getInputStream(ArchiveEntry entry,
                                  ArchiveEntry dstEntry)
                           throws IOException

Description copied from interface: InputArchive

Returns a new InputStream for reading the contents of the given archive entry.

The returned stream should preferrably be unbuffered, as buffering is usually done in higher layers (all copy routines in TrueZIP do this and most client applications do it, too). Buffering twice does not increase, but decrease performance.

Note that the stream is guaranteed to be closed before the InputArchive.close() method of this archive is called!

Specified by:

getInputStream in interface InputArchive

Parameters:

entry - A valid reference to an archive entry. The runtime class of this entry is the same as the runtime class of the entries returned by InputArchive.getArchiveEntries().

dstEntry - If not null, this identifies the entry to which TrueZIP is actually copying data to and should be used to implement the Direct Data Copying (DDC) feature. Note that there is no guarantee on the runtime type of this object; it may have been created by other drivers.

For example, the ZIP driver family uses this to determine if data should be provided in its deflated form if the destination entry is another ZIP file entry.

Returns:

A (preferrably unbuffered) InputStream to read the archive entry data from. null is not allowed!

Throws:

InputArchiveBusyException - If the archive is currently busy on input for another entry. This exception is guaranteed to be recoverable, meaning it should be possible to read the same entry again as soon as the archive is not busy on input anymore.

FileNotFoundException - If the archive entry does not exist or is not accessible for some reason.

IOException - On any other exceptional condition.

getMetaData

public InputArchiveMetaData getMetaData()

Description copied from interface: InputArchive

Returns the meta data for this input archive. The default value is null.

Specified by:

getMetaData in interface InputArchive

setMetaData

public void setMetaData(InputArchiveMetaData metaData)

Description copied from interface: InputArchive

Sets the meta data for this input archive.

Specified by:

setMetaData in interface InputArchive

Parameters:

metaData - The meta data - may not be null.