org.apache.commons.compress.compressors

## Class CompressorStreamFactory

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

- All Implemented Interfaces:
    CompressorStreamProvider

      public class CompressorStreamFactory
      extends Object
      implements CompressorStreamProvider

  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).

  Example (Compressing a file):

       final OutputStream out = Files.newOutputStream(output.toPath());
       CompressorOutputStream cos = new CompressorStreamFactory()
               .createCompressorOutputStream(CompressorStreamFactory.BZIP2, out);
       IOUtils.copy(Files.newInputStream(input.toPath()), cos);
       cos.close();

  Example (Decompressing a file):

       final InputStream is = Files.newInputStream(input.toPath());
       CompressorInputStream in = new CompressorStreamFactory().createCompressorInputStream(CompressorStreamFactory.BZIP2,
               is);
       IOUtils.copy(in, Files.newOutputStream(output.toPath()));
       in.close();

  This class is immutable
    provided that the deprecated method setDecompressConcatenated is not used.
  This class is thread-safe
    even if the deprecated method setDecompressConcatenated is used

- - ### Field Summary

    Fields
    Modifier and Type | Field and Description
    --- | ---
    `static String` | `BROTLI` Constant (value "br") used to identify the BROTLI compression algorithm.
    `static String` | `BZIP2` Constant (value "bzip2") used to identify the BZIP2 compression algorithm.
    `static String` | `DEFLATE` Constant (value "deflate") used to identify the Deflate compress method.
    `static String` | `DEFLATE64` Constant (value "deflate64") used to identify the Deflate64 compress method.
    `static String` | `GZIP` Constant (value "gz") used to identify the GZIP compression algorithm.
    `static String` | `LZ4_BLOCK` Constant (value "lz4-block") used to identify the block LZ4 compression method.
    `static String` | `LZ4_FRAMED` Constant (value "lz4-framed") used to identify the frame LZ4 compression method.
    `static String` | `LZMA` Constant (value "lzma") used to identify the LZMA compression method.
    `static String` | `PACK200` Constant (value "pack200") used to identify the PACK200 compression algorithm.
    `static String` | `SNAPPY_FRAMED` Constant (value "snappy-framed") used to identify the "framed" Snappy compression method.
    `static String` | `SNAPPY_RAW` Constant (value "snappy-raw") used to identify the "raw" Snappy compression method.
    `static String` | `XZ` Constant (value "xz") used to identify the XZ compression method.
    `static String` | `Z` Constant (value "z") used to identify the traditional Unix compress method.
    `static String` | `ZSTANDARD` Constant (value "zstd") used to identify the Zstandard compression algorithm.

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `CompressorStreamFactory()` Create an instance with the decompress Concatenated option set to false.
    `CompressorStreamFactory(boolean decompressUntilEOF)` Create an instance with the provided decompress Concatenated option.
    `CompressorStreamFactory(boolean decompressUntilEOF, int memoryLimitInKb)` Create an instance with the provided decompress Concatenated option.

  - ### Method Summary

    All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
    Modifier and Type | Method and Description
    --- | ---
    `CompressorInputStream` | `createCompressorInputStream(InputStream in)` Create an compressor input stream from an input stream, autodetecting the compressor type from the first few bytes of the stream.
    `CompressorInputStream` | `createCompressorInputStream(String name, InputStream in)` Creates a compressor input stream from a compressor name and an input stream.
    `CompressorInputStream` | `createCompressorInputStream(String name, InputStream in, boolean actualDecompressConcatenated)` Creates a compressor input stream from a compressor name and an input stream.
    `CompressorOutputStream` | `createCompressorOutputStream(String name, OutputStream out)` Creates an compressor output stream from an compressor name and an output stream.
    `static String` | `detect(InputStream inputStream)` Try to detect the type of compressor stream.
    `static SortedMap<String,CompressorStreamProvider>` | `findAvailableCompressorInputStreamProviders()` Constructs a new sorted map from input stream provider names to provider objects.
    `static SortedMap<String,CompressorStreamProvider>` | `findAvailableCompressorOutputStreamProviders()` Constructs a new sorted map from output stream provider names to provider objects.
    `static String` | `getBrotli()`
    `static String` | `getBzip2()`
    `SortedMap<String,CompressorStreamProvider>` | `getCompressorInputStreamProviders()`
    `SortedMap<String,CompressorStreamProvider>` | `getCompressorOutputStreamProviders()`
    `Boolean` | `getDecompressUntilEOF()`
    `static String` | `getDeflate()`
    `static String` | `getDeflate64()`
    `static String` | `getGzip()`
    `Set<String>` | `getInputStreamCompressorNames()` Gets all the input stream compressor names for this provider
    `static String` | `getLZ4Block()`
    `static String` | `getLZ4Framed()`
    `static String` | `getLzma()`
    `Set<String>` | `getOutputStreamCompressorNames()` Gets all the output stream compressor names for this provider
    `static String` | `getPack200()`
    `static CompressorStreamFactory` | `getSingleton()`
    `static String` | `getSnappyFramed()`
    `static String` | `getSnappyRaw()`
    `static String` | `getXz()`
    `static String` | `getZ()`
    `static String` | `getZstandard()`
    `void` | `setDecompressConcatenated(boolean decompressConcatenated)` Deprecated. 1.10 use the `CompressorStreamFactory(boolean)` constructor instead

    - ### Methods inherited from class java.lang.Object

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

- - ### Field Detail

    - #### BROTLI

          public static final String BROTLI

      Constant (value "br") used to identify the BROTLI compression algorithm.
      Since:
        1.14
      See Also:
        Constant Field Values

    - #### BZIP2

          public static final String BZIP2

      Constant (value "bzip2") used to identify the BZIP2 compression algorithm.
      Since:
        1.1
      See Also:
        Constant Field Values

    - #### GZIP

          public static final String GZIP

      Constant (value "gz") used to identify the GZIP compression algorithm.
      Since:
        1.1
      See Also:
        Constant Field Values

    - #### PACK200

          public static final String PACK200

      Constant (value "pack200") used to identify the PACK200 compression algorithm.
      Since:
        1.3
      See Also:
        Constant Field Values

    - #### XZ

          public static final String XZ

      Constant (value "xz") used to identify the XZ compression method.
      Since:
        1.4
      See Also:
        Constant Field Values

    - #### LZMA

          public static final String LZMA

      Constant (value "lzma") used to identify the LZMA compression method.
      Since:
        1.6
      See Also:
        Constant Field Values

    - #### SNAPPY_FRAMED

          public static final String SNAPPY_FRAMED

      Constant (value "snappy-framed") used to identify the "framed" Snappy compression method.
      Since:
        1.7
      See Also:
        Constant Field Values

    - #### SNAPPY_RAW

          public static final String SNAPPY_RAW

      Constant (value "snappy-raw") used to identify the "raw" Snappy compression method. Not supported as an output stream type.
      Since:
        1.7
      See Also:
        Constant Field Values

    - #### Z

          public static final String Z

      Constant (value "z") used to identify the traditional Unix compress method. Not supported as an output stream type.
      Since:
        1.7
      See Also:
        Constant Field Values

    - #### DEFLATE

          public static final String DEFLATE

      Constant (value "deflate") used to identify the Deflate compress method.
      Since:
        1.9
      See Also:
        Constant Field Values

    - #### DEFLATE64

          public static final String DEFLATE64

      Constant (value "deflate64") used to identify the Deflate64 compress method.
      Since:
        1.16
      See Also:
        Constant Field Values

    - #### LZ4_BLOCK

          public static final String LZ4_BLOCK

      Constant (value "lz4-block") used to identify the block LZ4 compression method.
      Since:
        1.14
      See Also:
        Constant Field Values

    - #### LZ4_FRAMED

          public static final String LZ4_FRAMED

      Constant (value "lz4-framed") used to identify the frame LZ4 compression method.
      Since:
        1.14
      See Also:
        Constant Field Values

    - #### ZSTANDARD

          public static final String ZSTANDARD

      Constant (value "zstd") used to identify the Zstandard compression algorithm. Not supported as an output stream type.
      Since:
        1.16
      See Also:
        Constant Field Values

  - ### Constructor Detail

    - #### CompressorStreamFactory

          public CompressorStreamFactory()

      Create an instance with the decompress Concatenated option set to false.

    - #### CompressorStreamFactory

          public CompressorStreamFactory(boolean decompressUntilEOF,
                                         int memoryLimitInKb)

      Create an instance with the provided decompress Concatenated option.
      Parameters:
        `decompressUntilEOF` - 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. This setting applies to the gzip, bzip2 and xz formats only.
        `memoryLimitInKb` - Some streams require allocation of potentially significant byte arrays/tables, and they can offer checks to prevent OOMs on corrupt files. Set the maximum allowed memory allocation in KBs.
      Since:
        1.14

    - #### CompressorStreamFactory

          public CompressorStreamFactory(boolean decompressUntilEOF)

      Create an instance with the provided decompress Concatenated option.
      Parameters:
        `decompressUntilEOF` - 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. This setting applies to the gzip, bzip2 and xz formats only.
      Since:
        1.10

  - ### Method Detail

    - #### findAvailableCompressorInputStreamProviders

          public static SortedMap<String,CompressorStreamProvider> findAvailableCompressorInputStreamProviders()

      Constructs a new sorted map from input stream provider names to provider objects.

      The map returned by this method will have one entry for each provider for which support is available in the current Java virtual machine. If two or more supported provider have the same name then the resulting map will contain just one of them; which one it will contain is not specified.

      The invocation of this method, and the subsequent use of the resulting map, may cause time-consuming disk or network I/O operations to occur. This method is provided for applications that need to enumerate all of the available providers, for example to allow user provider selection.

      This method may return different results at different times if new providers are dynamically made available to the current Java virtual machine.

      Returns:
        An immutable, map from names to provider objects
      Since:
        1.13

    - #### findAvailableCompressorOutputStreamProviders

          public static SortedMap<String,CompressorStreamProvider> findAvailableCompressorOutputStreamProviders()

      Constructs a new sorted map from output stream provider names to provider objects.

      The map returned by this method will have one entry for each provider for which support is available in the current Java virtual machine. If two or more supported provider have the same name then the resulting map will contain just one of them; which one it will contain is not specified.

      The invocation of this method, and the subsequent use of the resulting map, may cause time-consuming disk or network I/O operations to occur. This method is provided for applications that need to enumerate all of the available providers, for example to allow user provider selection.

      This method may return different results at different times if new providers are dynamically made available to the current Java virtual machine.

      Returns:
        An immutable, map from names to provider objects
      Since:
        1.13

    - #### getBrotli

          public static String getBrotli()

    - #### getBzip2

          public static String getBzip2()

    - #### getDeflate

          public static String getDeflate()

    - #### getDeflate64

          public static String getDeflate64()

      Returns:
        the constant `DEFLATE64`
      Since:
        1.16

    - #### getGzip

          public static String getGzip()

    - #### getLzma

          public static String getLzma()

    - #### getPack200

          public static String getPack200()

    - #### getSingleton

          public static CompressorStreamFactory getSingleton()

    - #### getSnappyFramed

          public static String getSnappyFramed()

    - #### getSnappyRaw

          public static String getSnappyRaw()

    - #### getXz

          public static String getXz()

    - #### getZ

          public static String getZ()

    - #### getLZ4Framed

          public static String getLZ4Framed()

    - #### getLZ4Block

          public static String getLZ4Block()

    - #### getZstandard

          public static String getZstandard()

    - #### detect

          public static String detect(InputStream inputStream)
                               throws CompressorException

      Try to detect the type of compressor stream.
      Parameters:
        `inputStream` - input stream
      Returns:
        type of compressor stream detected
      Throws:
        `CompressorException` - if no compressor stream type was detected or if something else went wrong
        `IllegalArgumentException` - if stream is null or does not support mark
      Since:
        1.14

    - #### 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:
        1.1

    - #### createCompressorInputStream

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

      Creates a compressor input stream from a compressor name and an input stream.
      Parameters:
        `name` - of the compressor, i.e. "gz", "bzip2", "xz", "lzma", "pack200", "snappy-raw", "snappy-framed", "z", "lz4-block", "lz4-framed", "zstd", "deflate64" or "deflate"
        `in` - the input stream
      Returns:
        compressor input stream
      Throws:
        `CompressorException` - if the compressor name is not known or not available, or if there's an IOException or MemoryLimitException thrown during initialization
        `IllegalArgumentException` - if the name or input stream is null

    - #### createCompressorInputStream

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

      Description copied from interface: `CompressorStreamProvider`
      Creates a compressor input stream from a compressor name and an input stream.
      Specified by:
        `createCompressorInputStream` in interface `CompressorStreamProvider`
      Parameters:
        `name` - of the compressor, i.e. "gz", "bzip2", "xz", "lzma", "pack200", "snappy-raw", "snappy-framed", "z" or "deflate"
        `in` - the input stream
        `actualDecompressConcatenated` - 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. This setting applies to the gzip, bzip2 and xz formats only.
      Returns:
        compressor input stream
      Throws:
        `CompressorException` - if the compressor name is not known

    - #### createCompressorOutputStream

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

      Creates an compressor output stream from an compressor name and an output stream.
      Specified by:
        `createCompressorOutputStream` in interface `CompressorStreamProvider`
      Parameters:
        `name` - the compressor name, i.e. "gz", "bzip2", "xz", "pack200", "snappy-framed", "lz4-block", "lz4-framed", "zstd" or "deflate"
        `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

    - #### getCompressorInputStreamProviders

          public SortedMap<String,CompressorStreamProvider> getCompressorInputStreamProviders()

    - #### getCompressorOutputStreamProviders

          public SortedMap<String,CompressorStreamProvider> getCompressorOutputStreamProviders()

    - #### getDecompressUntilEOF

          public Boolean getDecompressUntilEOF()

    - #### getInputStreamCompressorNames

          public Set<String> getInputStreamCompressorNames()

      Description copied from interface: `CompressorStreamProvider`
      Gets all the input stream compressor names for this provider
      Specified by:
        `getInputStreamCompressorNames` in interface `CompressorStreamProvider`
      Returns:
        all the input compressor names for this provider

    - #### getOutputStreamCompressorNames

          public Set<String> getOutputStreamCompressorNames()

      Description copied from interface: `CompressorStreamProvider`
      Gets all the output stream compressor names for this provider
      Specified by:
        `getOutputStreamCompressorNames` in interface `CompressorStreamProvider`
      Returns:
        all the output compressor names for this provider

    - #### setDecompressConcatenated

          @Deprecated
          public void setDecompressConcatenated(boolean decompressConcatenated)

      Deprecated. 1.10 use the `CompressorStreamFactory(boolean)` constructor instead
      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
      Throws:
        `IllegalStateException` - if the constructor `CompressorStreamFactory(boolean)` was used to create the factory
      Since:
        1.5

Copyright © 2002–2020 The Apache Software Foundation. All rights reserved.