org.apache.commons.compress.archivers.zip

Class ZipSplitReadOnlySeekableByteChannel

java.lang.Object

org.apache.commons.compress.utils.MultiReadOnlySeekableByteChannel

org.apache.commons.compress.archivers.zip.ZipSplitReadOnlySeekableByteChannel

All Implemented Interfaces:

Closeable, AutoCloseable, ByteChannel, Channel, ReadableByteChannel, SeekableByteChannel, WritableByteChannel

public class ZipSplitReadOnlySeekableByteChannel
extends MultiReadOnlySeekableByteChannel

MultiReadOnlySeekableByteChannel that knows what a split ZIP archive should look like.

If you want to read a split archive using ZipFile then create an instance of this class from the parts of the archive.

Since:

1.20

Constructor Summary

Constructors

Constructor and Description
ZipSplitReadOnlySeekableByteChannel(List<SeekableByteChannel> channels) Concatenates the given channels.

Method Summary

Modifier and Type	Method and Description
static SeekableByteChannel	buildFromLastSplitSegment(File lastSegmentFile) Concatenates zip split files from the last segment(the extension SHOULD be .zip)
static SeekableByteChannel	forFiles(File... files) Concatenates the given files.
static SeekableByteChannel	forFiles(File lastSegmentFile, Iterable<File> files) Concatenates the given files.
static SeekableByteChannel	forOrderedSeekableByteChannels(SeekableByteChannel... channels) Concatenates the given channels.
static SeekableByteChannel	forOrderedSeekableByteChannels(SeekableByteChannel lastSegmentChannel, Iterable<SeekableByteChannel> channels) Concatenates the given channels.

Methods inherited from class org.apache.commons.compress.utils.MultiReadOnlySeekableByteChannel

close, forSeekableByteChannels, isOpen, position, position, position, read, size, truncate, write

Methods inherited from class java.lang.Object

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

Constructor Detail

ZipSplitReadOnlySeekableByteChannel

public ZipSplitReadOnlySeekableByteChannel(List<SeekableByteChannel> channels)
                                    throws IOException

Concatenates the given channels.

The channels should be add in ascending order, e.g. z01, z02, ... z99, zip please note that the .zip file is the last segment and should be added as the last one in the channels

Parameters:

channels - the channels to concatenate

Throws:

NullPointerException - if channels is null

IOException - if the first channel doesn't seem to hold the beginning of a split archive

Method Detail

forOrderedSeekableByteChannels

public static SeekableByteChannel forOrderedSeekableByteChannels(SeekableByteChannel... channels)
                                                          throws IOException

Concatenates the given channels.

Parameters:

channels - the channels to concatenate, note that the LAST CHANNEL of channels should be the LAST SEGMENT(.zip) and theses channels should be added in correct order (e.g. .z01, .z02... .z99, .zip)

Returns:

SeekableByteChannel that concatenates all provided channels

Throws:

NullPointerException - if channels is null

IOException - if reading channels fails

forOrderedSeekableByteChannels

public static SeekableByteChannel forOrderedSeekableByteChannels(SeekableByteChannel lastSegmentChannel,
                                                                 Iterable<SeekableByteChannel> channels)
                                                          throws IOException

Concatenates the given channels.

Parameters:

lastSegmentChannel - channel of the last segment of split zip segments, its extension should be .zip

channels - the channels to concatenate except for the last segment, note theses channels should be added in correct order (e.g. .z01, .z02... .z99)

Returns:

SeekableByteChannel that concatenates all provided channels

Throws:

NullPointerException - if lastSegmentChannel or channels is null

IOException - if the first channel doesn't seem to hold the beginning of a split archive

buildFromLastSplitSegment

public static SeekableByteChannel buildFromLastSplitSegment(File lastSegmentFile)
                                                     throws IOException

Concatenates zip split files from the last segment(the extension SHOULD be .zip)

Parameters:

lastSegmentFile - the last segment of zip split files, note that the extension SHOULD be .zip

Returns:

SeekableByteChannel that concatenates all zip split files

Throws:

IllegalArgumentException - if the lastSegmentFile's extension is NOT .zip

IOException - if the first channel doesn't seem to hold the beginning of a split archive

forFiles

public static SeekableByteChannel forFiles(File... files)
                                    throws IOException

Concatenates the given files.

Parameters:

files - the files to concatenate, note that the LAST FILE of files should be the LAST SEGMENT(.zip) and theses files should be added in correct order (e.g. .z01, .z02... .z99, .zip)

Returns:

SeekableByteChannel that concatenates all provided files

Throws:

NullPointerException - if files is null

IOException - if opening a channel for one of the files fails

IOException - if the first channel doesn't seem to hold the beginning of a split archive

forFiles

public static SeekableByteChannel forFiles(File lastSegmentFile,
                                           Iterable<File> files)
                                    throws IOException

Concatenates the given files.

Parameters:

lastSegmentFile - the last segment of split zip segments, its extension should be .zip

files - the files to concatenate except for the last segment, note theses files should be added in correct order (e.g. .z01, .z02... .z99)

Returns:

SeekableByteChannel that concatenates all provided files

Throws:

IOException - if the first channel doesn't seem to hold the beginning of a split archive

NullPointerException - if files or lastSegmentFile is null