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 Description ZipSplitReadOnlySeekableByteChannel(List<SeekableByteChannel> channels)
Concatenates the given channels.
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method 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.
-
-
-
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 nullIOException
- 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 nullIOException
- 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 .zipchannels
- 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 nullIOException
- 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 .zipIOException
- 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 nullIOException
- if opening a channel for one of the files failsIOException
- 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 .zipfiles
- 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 archiveNullPointerException
- if files or lastSegmentFile is null
-
-