GZIPOutputStream

public class GZIPOutputStream
extends DeflaterOutputStream

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


This class implements a stream filter for writing compressed data in the GZIP file format.

Summary

Fields

protected CRC32 crc

CRC-32 of uncompressed data.

Inherited fields

Public constructors

GZIPOutputStream(OutputStream out, int size)

Creates a new output stream with the specified buffer size.

GZIPOutputStream(OutputStream out, int size, boolean syncFlush)

Creates a new output stream with the specified buffer size and flush mode.

GZIPOutputStream(OutputStream out)

Creates a new output stream with a default buffer size.

GZIPOutputStream(OutputStream out, boolean syncFlush)

Creates a new output stream with a default buffer size and the specified flush mode.

Public methods

void finish()

Finishes writing compressed data to the output stream without closing the underlying stream.

void write(byte[] buf, int off, int len)

Writes array of bytes to the compressed output stream.

Inherited methods

Fields

crc

Added in API level 1
protected CRC32 crc

CRC-32 of uncompressed data.

Public constructors

GZIPOutputStream

Added in API level 1
public GZIPOutputStream (OutputStream out, 
                int size)

Creates a new output stream with the specified buffer size.

The new output stream instance is created as if by invoking the 3-argument constructor GZIPOutputStream(out, size, false). Android-note: Android limits the number of UnbufferedIO operations that can be performed, so consider using buffered inputs with this class. More information can be found in the UnbufferedIO and StrictMode documentation.

Parameters
out OutputStream: the output stream

size int: the output buffer size

Throws
IOException If an I/O error has occurred.
IllegalArgumentException if size <= 0

GZIPOutputStream

Added in API level 19
public GZIPOutputStream (OutputStream out, 
                int size, 
                boolean syncFlush)

Creates a new output stream with the specified buffer size and flush mode.

Parameters
out OutputStream: the output stream

size int: the output buffer size

syncFlush boolean: if true invocation of the inherited flush() method of this instance flushes the compressor with flush mode Deflater#SYNC_FLUSH before flushing the output stream, otherwise only flushes the output stream

Throws
IOException If an I/O error has occurred.
IllegalArgumentException if size <= 0

GZIPOutputStream

Added in API level 1
public GZIPOutputStream (OutputStream out)

Creates a new output stream with a default buffer size.

The new output stream instance is created as if by invoking the 2-argument constructor GZIPOutputStream(out, false).

Parameters
out OutputStream: the output stream

Throws
IOException If an I/O error has occurred.

GZIPOutputStream

Added in API level 19
public GZIPOutputStream (OutputStream out, 
                boolean syncFlush)

Creates a new output stream with a default buffer size and the specified flush mode.

Parameters
out OutputStream: the output stream

syncFlush boolean: if true invocation of the inherited flush() method of this instance flushes the compressor with flush mode Deflater#SYNC_FLUSH before flushing the output stream, otherwise only flushes the output stream

Throws
IOException If an I/O error has occurred.

Public methods

finish

Added in API level 1
public void finish ()

Finishes writing compressed data to the output stream without closing the underlying stream. Use this method when applying multiple filters in succession to the same output stream.

Throws
IOException if an I/O error has occurred

write

Added in API level 1
public void write (byte[] buf, 
                int off, 
                int len)

Writes array of bytes to the compressed output stream. This method will block until all the bytes are written.

Parameters
buf byte: the data to be written

off int: the start offset of the data

len int: the length of the data

Throws
IOException If an I/O error has occurred.