ZipInputStream
public
class
ZipInputStream
extends InflaterInputStream
| java.lang.Object | ||||
| ↳ | java.io.InputStream | |||
| ↳ | java.io.FilterInputStream | |||
| ↳ | java.util.zip.InflaterInputStream | |||
| ↳ | java.util.zip.ZipInputStream | |||
This class implements an input stream filter for reading files in the ZIP file format. Includes support for both compressed and uncompressed entries.
Summary
Constants | |
|---|---|
int |
CENATT
|
int |
CENATX
|
int |
CENCOM
|
int |
CENCRC
|
int |
CENDSK
|
int |
CENEXT
|
int |
CENFLG
|
int |
CENHDR
|
int |
CENHOW
|
int |
CENLEN
|
int |
CENNAM
|
int |
CENOFF
|
long |
CENSIG
|
int |
CENSIZ
|
int |
CENTIM
|
int |
CENVEM
|
int |
CENVER
|
int |
ENDCOM
|
int |
ENDHDR
|
int |
ENDOFF
|
long |
ENDSIG
|
int |
ENDSIZ
|
int |
ENDSUB
|
int |
ENDTOT
|
int |
EXTCRC
|
int |
EXTHDR
|
int |
EXTLEN
|
long |
EXTSIG
|
int |
EXTSIZ
|
int |
LOCCRC
|
int |
LOCEXT
|
int |
LOCFLG
|
int |
LOCHDR
|
int |
LOCHOW
|
int |
LOCLEN
|
int |
LOCNAM
|
long |
LOCSIG
|
int |
LOCSIZ
|
int |
LOCTIM
|
int |
LOCVER
|
Inherited fields |
|---|
Public constructors | |
|---|---|
ZipInputStream(InputStream in)
Creates a new ZIP input stream. |
|
ZipInputStream(InputStream in, Charset charset)
Creates a new ZIP input stream. |
|
Public methods | |
|---|---|
int
|
available()
Returns 0 after EOF has reached for the current entry data, otherwise always return 1. |
void
|
close()
Closes this input stream and releases any system resources associated with the stream. |
void
|
closeEntry()
Closes the current ZIP entry and positions the stream for reading the next entry. |
ZipEntry
|
getNextEntry()
Reads the next ZIP file entry and positions the stream at the beginning of the entry data. |
int
|
read(byte[] b, int off, int len)
Reads from the current ZIP entry into an array of bytes. |
long
|
skip(long n)
Skips specified number of bytes in the current ZIP entry. |
Protected methods | |
|---|---|
ZipEntry
|
createZipEntry(String name)
Creates a new |
Inherited methods | |
|---|---|
Constants
CENSIG
public static final long CENSIG
Constant Value: 33639248 (0x0000000002014b50)
ENDSIG
public static final long ENDSIG
Constant Value: 101010256 (0x0000000006054b50)
EXTSIG
public static final long EXTSIG
Constant Value: 134695760 (0x0000000008074b50)
LOCSIG
public static final long LOCSIG
Constant Value: 67324752 (0x0000000004034b50)
Public constructors
ZipInputStream
public ZipInputStream (InputStream in)
Creates a new ZIP input stream.
The UTF-8 charset is used to
decode the entry names.
| Parameters | |
|---|---|
in |
InputStream: the actual input stream |
ZipInputStream
public ZipInputStream (InputStream in, Charset charset)
Creates a new ZIP input stream.
| Parameters | |
|---|---|
in |
InputStream: the actual input stream |
charset |
Charset: The charset to be
used to decode the ZIP entry name (ignored if the
language
encoding bit of the ZIP entry's general purpose bit
flag is set). |
Public methods
available
public int available ()
Returns 0 after EOF has reached for the current entry data, otherwise always return 1.
Programs should not count on this method to return the actual number of bytes that could be read without blocking.
| Returns | |
|---|---|
int |
1 before EOF and 0 after EOF has reached for current entry. |
| Throws | |
|---|---|
IOException |
if an I/O error occurs. |
close
public void close ()
Closes this input stream and releases any system resources associated with the stream.
| Throws | |
|---|---|
IOException |
if an I/O error has occurred |
closeEntry
public void closeEntry ()
Closes the current ZIP entry and positions the stream for reading the next entry.
| Throws | |
|---|---|
ZipException |
if a ZIP file error has occurred |
IOException |
if an I/O error has occurred |
getNextEntry
public ZipEntry getNextEntry ()
Reads the next ZIP file entry and positions the stream at the beginning of the entry data.
If the app targets Android U or above, zip file entry names containing
".." or starting with "/" passed here will throw a ZipException.
For more details, see ZipPathValidator.
| Returns | |
|---|---|
ZipEntry |
the next ZIP file entry, or null if there are no more entries |
| Throws | |
|---|---|
ZipException |
if (1) a ZIP file error has occurred or
(2) targetSdkVersion >= BUILD.VERSION_CODES.UPSIDE_DOWN_CAKE
and (the name argument contains ".." or starts with "/"). |
IOException |
if an I/O error has occurred |
read
public int read (byte[] b,
int off,
int len)
Reads from the current ZIP entry into an array of bytes.
If len is not zero, the method
blocks until some input is available; otherwise, no
bytes are read and 0 is returned.
| Parameters | |
|---|---|
b |
byte: the buffer into which the data is read |
off |
int: the start offset in the destination array b |
len |
int: the maximum number of bytes read |
| Returns | |
|---|---|
int |
the actual number of bytes read, or -1 if the end of the entry is reached |
| Throws | |
|---|---|
NullPointerException |
if b is null. |
IndexOutOfBoundsException |
if off is negative,
len is negative, or len is greater than
b.length - off |
ZipException |
if a ZIP file error has occurred |
IOException |
if an I/O error has occurred |
skip
public long skip (long n)
Skips specified number of bytes in the current ZIP entry.
| Parameters | |
|---|---|
n |
long: the number of bytes to skip |
| Returns | |
|---|---|
long |
the actual number of bytes skipped |
| Throws | |
|---|---|
ZipException |
if a ZIP file error has occurred |
IOException |
if an I/O error has occurred |
IllegalArgumentException |
if n < 0 |
Protected methods
createZipEntry
protected ZipEntry createZipEntry (String name)
Creates a new ZipEntry object for the specified
entry name.
| Parameters | |
|---|---|
name |
String: the ZIP file entry name |
| Returns | |
|---|---|
ZipEntry |
the ZipEntry just created |

