org.apache.commons.compress.compressors
Class CompressorStreamFactory

java.lang.Object
  org.apache.commons.compress.compressors.CompressorStreamFactory

public class CompressorStreamFactory
extends Object

Factory to create Compressor[In|Out]putStreams from names. To add other implementations you should extend CompressorStreamFactory and override the appropriate methods (and call their implementation from super of course).

 final OutputStream out = new FileOutputStream(output); 
 CompressorOutputStream cos = 
      new CompressorStreamFactory().createCompressorOutputStream(CompressorStreamFactory.BZIP2, out);
 IOUtils.copy(new FileInputStream(input), cos);
 cos.close();
 

 final InputStream is = new FileInputStream(input); 
 CompressorInputStream in = 
      new CompressorStreamFactory().createCompressorInputStream(CompressorStreamFactory.BZIP2, is);
 IOUtils.copy(in, new FileOutputStream(output));
 in.close();
 

BZIP2

public static final String BZIP2

Constant used to identify the BZIP2 compression algorithm.

Since:

Commons Compress 1.1

See Also:

Constant Field Values

GZIP

public static final String GZIP

Constant used to identify the GZIP compression algorithm.

Since:

Commons Compress 1.1

See Also:

Constant Field Values

PACK200

public static final String PACK200

Constant used to identify the PACK200 compression algorithm.

Since:

Commons Compress 1.3

See Also:

Constant Field Values

XZ

public static final String XZ

Constant used to identify the XZ compression method.

Since:

Commons Compress 1.4

See Also:

Constant Field Values

CompressorStreamFactory

public CompressorStreamFactory()

setDecompressConcatenated

public void setDecompressConcatenated(boolean decompressConcatenated)

Whether to decompress the full input or only the first stream in formats supporting multiple concatenated input streams.

This setting applies to the gzip, bzip2 and xz formats only.

Parameters:

decompressConcatenated - if true, decompress until the end of the input; if false, stop after the first stream and leave the input position to point to the next byte after the stream

Since:

Commons Compress 1.5

createCompressorInputStream

public CompressorInputStream createCompressorInputStream(InputStream in)
                                                  throws CompressorException

Create an compressor input stream from an input stream, autodetecting the compressor type from the first few bytes of the stream. The InputStream must support marks, like BufferedInputStream.

Parameters:

in - the input stream

Returns:

the compressor input stream

Throws:

CompressorException - if the compressor name is not known

IllegalArgumentException - if the stream is null or does not support mark

Since:

Commons Compress 1.1

createCompressorInputStream

public CompressorInputStream createCompressorInputStream(String name,
                                                         InputStream in)
                                                  throws CompressorException

Create a compressor input stream from a compressor name and an input stream.

Parameters:

name - of the compressor, i.e. "gz", "bzip2", "xz", or "pack200"

in - the input stream

Returns:

compressor input stream

Throws:

CompressorException - if the compressor name is not known

IllegalArgumentException - if the name or input stream is null

createCompressorOutputStream

public CompressorOutputStream createCompressorOutputStream(String name,
                                                           OutputStream out)
                                                    throws CompressorException

Create an compressor output stream from an compressor name and an input stream.

Parameters:

name - the compressor name, i.e. "gz", "bzip2", "xz", or "pack200"

out - the output stream

Returns:

the compressor output stream

Throws:

CompressorException - if the archiver name is not known

IllegalArgumentException - if the archiver name or stream is null