Module kala.compress.examples
Package kala.compress.archivers.examples

Class Expander

  • public class Expander
extends java.lang.Object
    Provides a high level API for expanding archives.
    Since:
    1.17

    • Constructor Summary

      Constructors 
      Constructor Description
      Expander()  

    • Method Summary

      All Methods Instance Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      void expand​(java.io.File archive, java.io.File targetDirectory)
      Expands archive into targetDirectory.
      void expand​(java.io.InputStream archive, java.io.File targetDirectory)
      Deprecated.
      this method leaks resources
      void expand​(java.io.InputStream archive, java.io.File targetDirectory, CloseableConsumer closeableConsumer)
      Expands archive into targetDirectory.
      void expand​(java.lang.String format, java.io.File archive, java.io.File targetDirectory)
      Expands archive into targetDirectory.
      void expand​(java.lang.String format, java.io.InputStream archive, java.io.File targetDirectory)
      Deprecated.
      this method leaks resources
      void expand​(java.lang.String format, java.io.InputStream archive, java.io.File targetDirectory, CloseableConsumer closeableConsumer)
      Expands archive into targetDirectory.
      void expand​(java.lang.String format, java.io.InputStream archive, java.nio.file.Path targetDirectory, CloseableConsumer closeableConsumer)
      Expands archive into targetDirectory.
      void expand​(java.lang.String format, java.nio.channels.SeekableByteChannel archive, java.io.File targetDirectory)
      Deprecated.
      this method leaks resources
      void expand​(java.lang.String format, java.nio.channels.SeekableByteChannel archive, java.io.File targetDirectory, CloseableConsumer closeableConsumer)
      Expands archive into targetDirectory.
      void expand​(java.lang.String format, java.nio.channels.SeekableByteChannel archive, java.nio.file.Path targetDirectory, CloseableConsumer closeableConsumer)
      Expands archive into targetDirectory.
      void expand​(java.lang.String format, java.nio.file.Path archive, java.nio.file.Path targetDirectory)
      Expands archive into targetDirectory.
      void expand​(java.nio.file.Path archive, java.nio.file.Path targetDirectory)
      Expands archive into targetDirectory.
      void expand​(ArchiveInputStream<?> archive, java.io.File targetDirectory)
      Expands archive into targetDirectory.
      void expand​(ArchiveInputStream<?> archive, java.nio.file.Path targetDirectory)
      Expands archive into targetDirectory.
      private <T extends ArchiveEntry>
      void      		 expand​(Expander.ArchiveEntrySupplier<T> supplier, Expander.ArchiveEntryBiConsumer<T> writer, java.nio.file.Path targetDirectory)  
      void expand​(SevenZArchiveReader archive, java.io.File targetDirectory)
      Expands archive into targetDirectory.
      void expand​(SevenZArchiveReader archive, java.nio.file.Path targetDirectory)
      Expands archive into targetDirectory.
      void expand​(TarArchiveReader archive, java.io.File targetDirectory)
      Expands archive into targetDirectory.
      void expand​(TarArchiveReader archive, java.nio.file.Path targetDirectory)
      Expands archive into targetDirectory.
      void expand​(ZipArchiveReader archive, java.io.File targetDirectory)
      Expands archive into targetDirectory.
      void expand​(ZipArchiveReader archive, java.nio.file.Path targetDirectory)
      Expands archive into targetDirectory.
      private boolean prefersSeekableByteChannel​(java.lang.String format)  
      private java.nio.file.Path toPath​(java.io.File targetDirectory)  

      • Methods inherited from class java.lang.Object

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

    • Constructor Detail

      • Expander

        public Expander()

    • Method Detail

      • expand

        public void expand​(ArchiveInputStream<?> archive,
                   java.io.File targetDirectory)
            throws java.io.IOException
        Expands archive into targetDirectory.
        Parameters:
        archive - the file to expand
        targetDirectory - the target directory, may be null to simulate output to dev/null on Linux and NUL on Windows.
        Throws:
        java.io.IOException - if an I/O error occurs

      • expand

        public void expand​(ArchiveInputStream<?> archive,
                   java.nio.file.Path targetDirectory)
            throws java.io.IOException
        Expands archive into targetDirectory.
        Parameters:
        archive - the file to expand
        targetDirectory - the target directory, may be null to simulate output to dev/null on Linux and NUL on Windows.
        Throws:
        java.io.IOException - if an I/O error occurs
        Since:
        1.22

      • expand

        public void expand​(java.io.File archive,
                   java.io.File targetDirectory)
            throws java.io.IOException,
                   ArchiveException
        Expands archive into targetDirectory.

        Tries to auto-detect the archive's format.

        Parameters:
        archive - the file to expand
        targetDirectory - the target directory
        Throws:
        java.io.IOException - if an I/O error occurs
        ArchiveException - if the archive cannot be read for other reasons

      • expand

        @Deprecated
public void expand​(java.io.InputStream archive,
                   java.io.File targetDirectory)
            throws java.io.IOException,
                   ArchiveException
        Deprecated.
        this method leaks resources
        Expands archive into targetDirectory.

        Tries to auto-detect the archive's format.

        This method creates a wrapper around the archive stream which is never closed and thus leaks resources, please use expand(InputStream,File,CloseableConsumer) instead.

        Parameters:
        archive - the file to expand
        targetDirectory - the target directory
        Throws:
        java.io.IOException - if an I/O error occurs
        ArchiveException - if the archive cannot be read for other reasons

      • expand

        public void expand​(java.io.InputStream archive,
                   java.io.File targetDirectory,
                   CloseableConsumer closeableConsumer)
            throws java.io.IOException,
                   ArchiveException
        Expands archive into targetDirectory.

        Tries to auto-detect the archive's format.

        This method creates a wrapper around the archive stream and the caller of this method is responsible for closing it - probably at the same time as closing the stream itself. The caller is informed about the wrapper object via the closeableConsumer callback as soon as it is no longer needed by this class.

        Parameters:
        archive - the file to expand
        targetDirectory - the target directory
        closeableConsumer - is informed about the stream wrapped around the passed in stream
        Throws:
        java.io.IOException - if an I/O error occurs
        ArchiveException - if the archive cannot be read for other reasons
        Since:
        1.19

      • expand

        public void expand​(java.nio.file.Path archive,
                   java.nio.file.Path targetDirectory)
            throws java.io.IOException,
                   ArchiveException
        Expands archive into targetDirectory.

        Tries to auto-detect the archive's format.

        Parameters:
        archive - the file to expand
        targetDirectory - the target directory
        Throws:
        java.io.IOException - if an I/O error occurs
        ArchiveException - if the archive cannot be read for other reasons
        Since:
        1.22

      • expand

        public void expand​(SevenZArchiveReader archive,
                   java.io.File targetDirectory)
            throws java.io.IOException
        Expands archive into targetDirectory.
        Parameters:
        archive - the file to expand
        targetDirectory - the target directory, may be null to simulate output to dev/null on Linux and NUL on Windows.
        Throws:
        java.io.IOException - if an I/O error occurs

      • expand

        public void expand​(SevenZArchiveReader archive,
                   java.nio.file.Path targetDirectory)
            throws java.io.IOException
        Expands archive into targetDirectory.
        Parameters:
        archive - the file to expand
        targetDirectory - the target directory, may be null to simulate output to dev/null on Linux and NUL on Windows.
        Throws:
        java.io.IOException - if an I/O error occurs
        Since:
        1.22

      • expand

        public void expand​(java.lang.String format,
                   java.io.File archive,
                   java.io.File targetDirectory)
            throws java.io.IOException,
                   ArchiveException
        Expands archive into targetDirectory.
        Parameters:
        archive - the file to expand
        targetDirectory - the target directory
        format - the archive format. This uses the same format as accepted by ArchiveStreamFactory.
        Throws:
        java.io.IOException - if an I/O error occurs
        ArchiveException - if the archive cannot be read for other reasons

      • expand

        @Deprecated
public void expand​(java.lang.String format,
                   java.io.InputStream archive,
                   java.io.File targetDirectory)
            throws java.io.IOException,
                   ArchiveException
        Deprecated.
        this method leaks resources
        Expands archive into targetDirectory.

        This method creates a wrapper around the archive stream which is never closed and thus leaks resources, please use expand(String,InputStream,File,CloseableConsumer) instead.

        Parameters:
        archive - the file to expand
        targetDirectory - the target directory
        format - the archive format. This uses the same format as accepted by ArchiveStreamFactory.
        Throws:
        java.io.IOException - if an I/O error occurs
        ArchiveException - if the archive cannot be read for other reasons

      • expand

        public void expand​(java.lang.String format,
                   java.io.InputStream archive,
                   java.io.File targetDirectory,
                   CloseableConsumer closeableConsumer)
            throws java.io.IOException,
                   ArchiveException
        Expands archive into targetDirectory.

        This method creates a wrapper around the archive stream and the caller of this method is responsible for closing it - probably at the same time as closing the stream itself. The caller is informed about the wrapper object via the closeableConsumer callback as soon as it is no longer needed by this class.

        Parameters:
        archive - the file to expand
        targetDirectory - the target directory
        format - the archive format. This uses the same format as accepted by ArchiveStreamFactory.
        closeableConsumer - is informed about the stream wrapped around the passed in stream
        Throws:
        java.io.IOException - if an I/O error occurs
        ArchiveException - if the archive cannot be read for other reasons
        Since:
        1.19

      • expand

        public void expand​(java.lang.String format,
                   java.io.InputStream archive,
                   java.nio.file.Path targetDirectory,
                   CloseableConsumer closeableConsumer)
            throws java.io.IOException,
                   ArchiveException
        Expands archive into targetDirectory.

        This method creates a wrapper around the archive stream and the caller of this method is responsible for closing it - probably at the same time as closing the stream itself. The caller is informed about the wrapper object via the closeableConsumer callback as soon as it is no longer needed by this class.

        Parameters:
        archive - the file to expand
        targetDirectory - the target directory
        format - the archive format. This uses the same format as accepted by ArchiveStreamFactory.
        closeableConsumer - is informed about the stream wrapped around the passed in stream
        Throws:
        java.io.IOException - if an I/O error occurs
        ArchiveException - if the archive cannot be read for other reasons
        Since:
        1.22

      • expand

        public void expand​(java.lang.String format,
                   java.nio.file.Path archive,
                   java.nio.file.Path targetDirectory)
            throws java.io.IOException,
                   ArchiveException
        Expands archive into targetDirectory.
        Parameters:
        archive - the file to expand
        targetDirectory - the target directory
        format - the archive format. This uses the same format as accepted by ArchiveStreamFactory.
        Throws:
        java.io.IOException - if an I/O error occurs
        ArchiveException - if the archive cannot be read for other reasons
        Since:
        1.22

      • expand

        @Deprecated
public void expand​(java.lang.String format,
                   java.nio.channels.SeekableByteChannel archive,
                   java.io.File targetDirectory)
            throws java.io.IOException,
                   ArchiveException
        Deprecated.
        this method leaks resources
        Expands archive into targetDirectory.

        This method creates a wrapper around the archive channel which is never closed and thus leaks resources, please use expand(String,SeekableByteChannel,File,CloseableConsumer) instead.

        Parameters:
        archive - the file to expand
        targetDirectory - the target directory
        format - the archive format. This uses the same format as accepted by ArchiveStreamFactory.
        Throws:
        java.io.IOException - if an I/O error occurs
        ArchiveException - if the archive cannot be read for other reasons

      • expand

        public void expand​(java.lang.String format,
                   java.nio.channels.SeekableByteChannel archive,
                   java.io.File targetDirectory,
                   CloseableConsumer closeableConsumer)
            throws java.io.IOException,
                   ArchiveException
        Expands archive into targetDirectory.

        This method creates a wrapper around the archive channel and the caller of this method is responsible for closing it - probably at the same time as closing the channel itself. The caller is informed about the wrapper object via the closeableConsumer callback as soon as it is no longer needed by this class.

        Parameters:
        archive - the file to expand
        targetDirectory - the target directory
        format - the archive format. This uses the same format as accepted by ArchiveStreamFactory.
        closeableConsumer - is informed about the stream wrapped around the passed in channel
        Throws:
        java.io.IOException - if an I/O error occurs
        ArchiveException - if the archive cannot be read for other reasons
        Since:
        1.19

      • expand

        public void expand​(java.lang.String format,
                   java.nio.channels.SeekableByteChannel archive,
                   java.nio.file.Path targetDirectory,
                   CloseableConsumer closeableConsumer)
            throws java.io.IOException,
                   ArchiveException
        Expands archive into targetDirectory.

        This method creates a wrapper around the archive channel and the caller of this method is responsible for closing it - probably at the same time as closing the channel itself. The caller is informed about the wrapper object via the closeableConsumer callback as soon as it is no longer needed by this class.

        Parameters:
        archive - the file to expand
        targetDirectory - the target directory
        format - the archive format. This uses the same format as accepted by ArchiveStreamFactory.
        closeableConsumer - is informed about the stream wrapped around the passed in channel
        Throws:
        java.io.IOException - if an I/O error occurs
        ArchiveException - if the archive cannot be read for other reasons
        Since:
        1.22

      • expand

        public void expand​(TarArchiveReader archive,
                   java.io.File targetDirectory)
            throws java.io.IOException
        Expands archive into targetDirectory.
        Parameters:
        archive - the file to expand
        targetDirectory - the target directory, may be null to simulate output to dev/null on Linux and NUL on Windows.
        Throws:
        java.io.IOException - if an I/O error occurs
        Since:
        1.21

      • expand

        public void expand​(TarArchiveReader archive,
                   java.nio.file.Path targetDirectory)
            throws java.io.IOException
        Expands archive into targetDirectory.
        Parameters:
        archive - the file to expand
        targetDirectory - the target directory, may be null to simulate output to dev/null on Linux and NUL on Windows.
        Throws:
        java.io.IOException - if an I/O error occurs
        Since:
        1.22

      • expand

        public void expand​(ZipArchiveReader archive,
                   java.io.File targetDirectory)
            throws java.io.IOException
        Expands archive into targetDirectory.
        Parameters:
        archive - the file to expand
        targetDirectory - the target directory, may be null to simulate output to dev/null on Linux and NUL on Windows.
        Throws:
        java.io.IOException - if an I/O error occurs

      • expand

        public void expand​(ZipArchiveReader archive,
                   java.nio.file.Path targetDirectory)
            throws java.io.IOException
        Expands archive into targetDirectory.
        Parameters:
        archive - the file to expand
        targetDirectory - the target directory, may be null to simulate output to dev/null on Linux and NUL on Windows.
        Throws:
        java.io.IOException - if an I/O error occurs
        Since:
        1.22

      • prefersSeekableByteChannel

        private boolean prefersSeekableByteChannel​(java.lang.String format)

      • toPath

        private java.nio.file.Path toPath​(java.io.File targetDirectory)