Package de.schlichtherle.io.archive.spi

The Service Provider Interface (SPI) for pluggable ArchiveDrivers.

See:
Description

Interface Summary

ArchiveDriver	This "driver" interface is used in a Builder software pattern as the Builder or Abstract Factory which reads and writes archives of a particular type, e.g.
ArchiveEntry	A simple interface for entries in an archive.
ArchiveEntryFactory	Deprecated. Thie interface will vanish in TrueZIP 7.
InputArchive	Defines the interface used to read entries from an archive file.
OutputArchive	Defines the interface used to write entries to an archive file.

Class Summary

AbstractArchiveDriver	An abstract archive driver implementation to ease the task of developing an archive driver.
MultiplexedOutputArchive	A decorator for output archives which allows to write an unlimited number of entries concurrently while actually only one entry is written at a time to the target output archive.
RfsEntry	A utility class which adapts a File instance to an ArchiveEntry (RFS means Real File System).

Exception Summary

InputArchiveBusyException	Thrown to indicate that the InputArchive.getInputStream(de.schlichtherle.io.archive.spi.ArchiveEntry, de.schlichtherle.io.archive.spi.ArchiveEntry) method failed because the archive is already busy on input.
OutputArchiveBusyException	Thrown to indicate that the OutputArchive.getOutputStream(de.schlichtherle.io.archive.spi.ArchiveEntry, de.schlichtherle.io.archive.spi.ArchiveEntry) method failed because the archive is already busy on output.
TransientIOException	May be thrown by archive drivers to indicate that an IOException occured as a transient event when accessing an archive file and another try to access the same archive file may finally succeed.

Error Summary

AbstractArchiveDriver.InconsistentCharsetSupportError

Thrown to indicate that the character set implementation in the Java Runtime Environment (JRE) for the Java Standard Edition (JSE) is broken and needs fixing.

Package de.schlichtherle.io.archive.spi Description

The Service Provider Interface (SPI) for pluggable ArchiveDrivers. The interfaces and classes in this package are used by some package private classes in the package de.schlichtherle.io in order to access archive files without requiring to know the archive type.

To implement support for a custom archive type, developers must implement the interfaces in this package and either provide a custom implementation of the ArchiveDetector interface or register the driver class with the DefaultArchiveDetector class.

Some classes in this package are provided to ease the task of implementing an archive driver.