com.atlassian.bamboo.utils.archive

Class ArchiveUtils

java.lang.Object

com.atlassian.bamboo.utils.archive.ArchiveUtils

@Internal
public class ArchiveUtils
extends Object

Utilities related to operations on archives.

Method Summary

Modifier and Type	Method and Description
static void	compressFiles(ArchiverType archiverType, Iterable<File> sourceFiles, File archiveFile, File baseDirectory) Compresses multiple files into a single archive.
static void	extractArchive(ArchiverType archiverType, File archiveFile, File destinationDirectory) Extracts an archive contents into the provided destination directory.

Methods inherited from class java.lang.Object

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

Method Detail

compressFiles

public static void compressFiles(@NotNull
                                 ArchiverType archiverType,
                                 @NotNull
                                 Iterable<File> sourceFiles,
                                 @NotNull
                                 File archiveFile,
                                 @Nullable
                                 File baseDirectory)
                          throws IOException

Compresses multiple files into a single archive. The output archive file will be created - it can't exist before calling this method.

Parameters:

archiverType - Type of archiver that will be used to package the files.

sourceFiles - Files to archive. Each file must exist.

archiveFile - Archive file to create. Must not exist.

baseDirectory - Optional argument: base directory of all the files to compress. If given, all file paths in the resulting archive will be calculated relatively to this directory. Must exist. If skipped, all source files will be placed in the archive root.

Throws:

IOException - if any IO operation fails (e.g. insufficient permissions to create new file)

IllegalArgumentException - if passed arguments do not meet requirements

extractArchive

public static void extractArchive(@NotNull
                                  ArchiverType archiverType,
                                  @NotNull
                                  File archiveFile,
                                  @NotNull
                                  File destinationDirectory)
                           throws IOException

Extracts an archive contents into the provided destination directory.

Parameters:

archiverType - Type of archiver that will be used to extract archive files.

archiveFile - Archive file. Must exists.

destinationDirectory - Directory to which the content of the archive should be copied. Must exist.

Throws:

IOException - if any IO operation fails (e.g. insufficient permissions to create new file)

IllegalArgumentException - if passed arguments do not meet requirements