to top
Android APIs
public class

GZIPOutputStream

extends DeflaterOutputStream
java.lang.Object
   ↳ java.io.OutputStream
     ↳ java.io.FilterOutputStream
       ↳ java.util.zip.DeflaterOutputStream
         ↳ java.util.zip.GZIPOutputStream

Class Overview

The GZIPOutputStream class is used to write data to a stream in the GZIP storage format.

Example

Using GZIPOutputStream is a little easier than ZipOutputStream because GZIP is only for compression, and is not a container for multiple files. This code creates a GZIP stream, similar to the gzip(1) utility. 

 OutputStream os = ...
 byte[] bytes = ...
 GZIPOutputStream zos = new GZIPOutputStream(new BufferedOutputStream(os));
 try {
     zos.write(bytes);
 } finally {
     zos.close();
 }

Summary

Fields
protected CRC32 crc The checksum algorithm used when treating uncompressed data.
[Expand]
Inherited Fields
From class java.util.zip.DeflaterOutputStream
From class java.io.FilterOutputStream
Public Constructors
GZIPOutputStream(OutputStream os)
Constructs a new GZIPOutputStream to write data in GZIP format to the given stream.
GZIPOutputStream(OutputStream os, boolean syncFlush)
Constructs a new GZIPOutputStream to write data in GZIP format to the given stream with the given flushing behavior (see flush()).
GZIPOutputStream(OutputStream os, int bufferSize)
Constructs a new GZIPOutputStream to write data in GZIP format to the given stream with the given internal buffer size and flushing behavior (see flush()).
GZIPOutputStream(OutputStream os, int bufferSize, boolean syncFlush)
Constructs a new GZIPOutputStream to write data in GZIP format to the given stream with the given internal buffer size and flushing behavior (see flush()).
Public Methods
void finish()
Indicates to the stream that all data has been written out, and any GZIP terminal data can now be written.
void write(byte[] buffer, int off, int nbytes)
Write up to nbytes of data from the given buffer, starting at offset off, to the underlying stream in GZIP format.
[Expand]
Inherited Methods
From class java.util.zip.DeflaterOutputStream
From class java.io.FilterOutputStream
From class java.io.OutputStream
From class java.lang.Object
From interface java.io.Closeable
From interface java.io.Flushable
From interface java.lang.AutoCloseable

Fields

protected CRC32 crc

Added in API level 1

The checksum algorithm used when treating uncompressed data.

Public Constructors

public GZIPOutputStream (OutputStream os)

Added in API level 1

Constructs a new GZIPOutputStream to write data in GZIP format to the given stream.

Throws
IOException

public GZIPOutputStream (OutputStream os, boolean syncFlush)

Added in API level 19

Constructs a new GZIPOutputStream to write data in GZIP format to the given stream with the given flushing behavior (see flush()).

Throws
IOException

public GZIPOutputStream (OutputStream os, int bufferSize)

Added in API level 1

Constructs a new GZIPOutputStream to write data in GZIP format to the given stream with the given internal buffer size and flushing behavior (see flush()).

Throws
IOException

public GZIPOutputStream (OutputStream os, int bufferSize, boolean syncFlush)

Added in API level 19

Constructs a new GZIPOutputStream to write data in GZIP format to the given stream with the given internal buffer size and flushing behavior (see flush()).

Throws
IOException

Public Methods

public void finish ()

Added in API level 1

Indicates to the stream that all data has been written out, and any GZIP terminal data can now be written.

Throws
IOException if an IOException occurs.

public void write (byte[] buffer, int off, int nbytes)

Added in API level 1

Write up to nbytes of data from the given buffer, starting at offset off, to the underlying stream in GZIP format.

Parameters
buffer the buffer to write.
off the index of the first byte in buffer to write.
nbytes the number of bytes in buffer to write.
Throws
IOException