Module kala.compress.compressors.gzip

Package kala.compress.compressors.gzip

Class GzipCompressorOutputStream

java.lang.Object

java.io.OutputStream

java.io.FilterOutputStream

kala.compress.compressors.CompressorOutputStream<OutputStream>

kala.compress.compressors.gzip.GzipCompressorOutputStream

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable

public class GzipCompressorOutputStream
extends CompressorOutputStream<OutputStream>

Compressed output stream using the gzip format. This implementation improves over the standard GZIPOutputStream class by allowing the configuration of the compression level and the header metadata (file name, comment, modification time, operating system and extra flags).

See Also:

• RFC 1952 GZIP File Format Specification

Field Summary

Fields

Modifier and Type	Field	Description
private boolean	closed	Indicates if the stream has been closed
private final CRC32	crc	The checksum of the uncompressed data
private final byte[]	deflateBuffer	The buffer receiving the compressed data from the deflater
private final Deflater	deflater	Deflater used to compress the data
private static final int	FCOMMENT	Header flag indicating a comment follows the header
private static final int	FEXTRA	Header flag indicating an EXTRA subfields collection follows the header
private static final int	FNAME	Header flag indicating a file name follows the header

Fields inherited from class java.io.FilterOutputStream

out

Constructor Summary

Constructors

Constructor	Description
GzipCompressorOutputStream(OutputStream out)	Creates a gzip compressed output stream with the default parameters.
GzipCompressorOutputStream(OutputStream out, GzipParameters parameters)	Creates a gzip compressed output stream with the specified parameters.

Method Summary

Modifier and Type	Method	Description
void	close()
private void	deflate()
void	finish()	Finishes writing compressed data to the underlying stream without closing it.
void	write(byte[] buffer)
void	write(byte[] buffer, int offset, int length)
void	write(int b)
private void	write(String value, Charset charset)	Writes a NUL-terminated String encoded with the charset.
private void	writeHeader(GzipParameters parameters)
private void	writeTrailer()

Methods inherited from class kala.compress.compressors.CompressorOutputStream

out

Methods inherited from class java.io.FilterOutputStream

flush

Methods inherited from class java.io.OutputStream

nullOutputStream

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

FEXTRA

private static final int FEXTRA

Header flag indicating an EXTRA subfields collection follows the header

See Also:

• Constant Field Values

FNAME

private static final int FNAME

Header flag indicating a file name follows the header

See Also:

• Constant Field Values

FCOMMENT

private static final int FCOMMENT

Header flag indicating a comment follows the header

See Also:

• Constant Field Values

deflater

private final Deflater deflater

Deflater used to compress the data

deflateBuffer

private final byte[] deflateBuffer

The buffer receiving the compressed data from the deflater

closed

private boolean closed

Indicates if the stream has been closed

crc

private final CRC32 crc

The checksum of the uncompressed data

Constructor Details

GzipCompressorOutputStream

public GzipCompressorOutputStream(OutputStream out)
                           throws IOException

Creates a gzip compressed output stream with the default parameters.

Parameters:

out - the stream to compress to

Throws:

IOException - if writing fails

GzipCompressorOutputStream

public GzipCompressorOutputStream(OutputStream out,
 GzipParameters parameters)
                           throws IOException

Creates a gzip compressed output stream with the specified parameters.

Parameters:

out - the stream to compress to

parameters - the parameters to use

Throws:

IOException - if writing fails

Since:

1.7

Method Details

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Overrides:

close in class FilterOutputStream

Throws:

IOException

deflate

private void deflate()
              throws IOException

Throws:

IOException

finish

public void finish()
            throws IOException

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

Throws:

IOException - on error

Since:

1.7

write

public void write(byte[] buffer)
           throws IOException

Overrides:

write in class FilterOutputStream

Throws:

IOException

Since:

1.1

write

public void write(byte[] buffer,
 int offset,
 int length)
           throws IOException

Overrides:

write in class FilterOutputStream

Throws:

IOException

Since:

1.1

write

public void write(int b)
           throws IOException

Overrides:

write in class FilterOutputStream

Throws:

IOException

write

private void write(String value,
 Charset charset)
            throws IOException

Writes a NUL-terminated String encoded with the charset.

Parameters:

value - The String to write.

charset - Specifies the Charset to use.

Throws:

IOException - if an I/O error occurs.

writeHeader

private void writeHeader(GzipParameters parameters)
                  throws IOException

Throws:

IOException

writeTrailer

private void writeTrailer()
                   throws IOException

Throws:

IOException