Android APIs
public class

GZIPInputStream

extends InflaterInputStream
java.lang.Object
   ↳ java.io.InputStream
     ↳ java.io.FilterInputStream
       ↳ java.util.zip.InflaterInputStream
         ↳ java.util.zip.GZIPInputStream

Class Overview

The GZIPInputStream class is used to read data stored in the GZIP format, reading and decompressing GZIP data from the underlying stream into its buffer.

Example

Using GZIPInputStream is easier than ZipInputStream because GZIP is only for compression, and is not a container for multiple files. This code decompresses the data from a GZIP stream, similar to the gunzip(1) utility.

 InputStream is = ...
 GZIPInputStream zis = new GZIPInputStream(new BufferedInputStream(is));
 try {
     // Reading from 'zis' gets you the uncompressed bytes...
     processStream(zis);
 } finally {
     zis.close();
 }
 

Note that this class ignores all remaining data at the end of the last GZIP member.

Summary

Constants
int GZIP_MAGIC The magic header for the GZIP format.
Fields
protected CRC32 crc The checksum algorithm used when handling uncompressed data.
protected boolean eos Indicates the end of the input stream.
[Expand]
Inherited Fields
From class java.util.zip.InflaterInputStream
From class java.io.FilterInputStream
Public Constructors
GZIPInputStream(InputStream is)
Construct a GZIPInputStream to read from GZIP data from the underlying stream.
GZIPInputStream(InputStream is, int size)
Construct a GZIPInputStream to read from GZIP data from the underlying stream.
Public Methods
void close()
Closes this stream and any underlying streams.
int read(byte[] buffer, int byteOffset, int byteCount)
Reads up to byteCount bytes of decompressed data and stores it in buffer starting at byteOffset.
[Expand]
Inherited Methods
From class java.util.zip.InflaterInputStream
From class java.io.FilterInputStream
From class java.io.InputStream
From class java.lang.Object
From interface java.io.Closeable
From interface java.lang.AutoCloseable

Constants

public static final int GZIP_MAGIC

Added in API level 1

The magic header for the GZIP format.

Constant Value: 35615 (0x00008b1f)

Fields

protected CRC32 crc

Added in API level 1

The checksum algorithm used when handling uncompressed data.

protected boolean eos

Added in API level 1

Indicates the end of the input stream.

Public Constructors

public GZIPInputStream (InputStream is)

Added in API level 1

Construct a GZIPInputStream to read from GZIP data from the underlying stream.

Parameters
is the InputStream to read data from.
Throws
IOException if an IOException occurs.

public GZIPInputStream (InputStream is, int size)

Added in API level 1

Construct a GZIPInputStream to read from GZIP data from the underlying stream. Set the internal buffer size to size.

Parameters
is the InputStream to read data from.
size the internal read buffer size.
Throws
IOException if an IOException occurs.

Public Methods

public void close ()

Added in API level 1

Closes this stream and any underlying streams.

Throws
IOException

public int read (byte[] buffer, int byteOffset, int byteCount)

Added in API level 1

Reads up to byteCount bytes of decompressed data and stores it in buffer starting at byteOffset. Returns the number of uncompressed bytes read, or -1.

Parameters
buffer
byteOffset
byteCount
Returns
int
Throws
IOException