org.apache.tools.bzip2

Class CBZip2InputStream

public class CBZip2InputStream extends InputStream implements BZip2Constants

An input stream that decompresses from the BZip2 format (without the file header chars) to be read as any other stream.

The decompression requires large amounts of memory. Thus you should call the close() method as soon as possible, to force CBZip2InputStream to release the allocated memory. See CBZip2OutputStream for information about memory usage.

CBZip2InputStream reads bytes from the compressed source stream via the single byte java.io.InputStream#read() read() method exclusively. Thus you should consider to use a buffered source stream.

Instances of this class are not threadsafe.

Constructor Summary
CBZip2InputStream(InputStream in)
Constructs a new CBZip2InputStream which decompresses bytes read from the specified stream.
Method Summary
voidclose()
intread()
intread(byte[] dest, int offs, int len)

Constructor Detail

CBZip2InputStream

public CBZip2InputStream(InputStream in)
Constructs a new CBZip2InputStream which decompresses bytes read from the specified stream.

Although BZip2 headers are marked with the magic "Bz" this constructor expects the next byte in the stream to be the first one after the magic. Thus callers have to skip the first two bytes. Otherwise this constructor will throw an exception.

Throws: IOException if the stream content is malformed or an I/O error occurs. NullPointerException if in == null

Method Detail

close

public void close()

read

public int read()

read

public int read(byte[] dest, int offs, int len)