Class ZipSplitReadOnlySeekableByteChannel
- All Implemented Interfaces:
Closeable
,AutoCloseable
,ByteChannel
,Channel
,ReadableByteChannel
,SeekableByteChannel
,WritableByteChannel
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
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionprivate static class
-
Field Summary
Fields -
Constructor Summary
ConstructorsConstructorDescriptionConcatenates the given channels. -
Method Summary
Modifier and TypeMethodDescriptionprivate void
assertSplitSignature
(List<SeekableByteChannel> channels) Based on the zip specification:static SeekableByteChannel
buildFromLastSplitSegment
(File lastSegmentFile) Concatenates zip split files from the last segment(the extension SHOULD be .zip)static SeekableByteChannel
Concatenates the given files.static SeekableByteChannel
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.
-
Field Details
-
ZIP_SPLIT_SIGNATURE_LENGTH
private static final int ZIP_SPLIT_SIGNATURE_LENGTH- See Also:
-
zipSplitSignatureByteBuffer
-
-
Constructor Details
-
ZipSplitReadOnlySeekableByteChannel
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 Details
-
assertSplitSignature
Based on the zip specification:8.5.3 Spanned/Split archives created using PKZIP for Windows (V2.50 or greater), PKZIP Command Line (V2.50 or greater), or PKZIP Explorer will include a special spanning signature as the first 4 bytes of the first segment of the archive. This signature (0x08074b50) will be followed immediately by the local header signature for the first file in the archive.
the first 4 bytes of the first zip split segment should be the zip split signature(0x08074B50)
- Parameters:
channels
- channels to be validated- Throws:
IOException
-
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
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
-