Package jetbrains.buildServer.util

Interface ArchiveExtractorManager

All Known Implementing Classes:

ArchiveExtractorManagerImpl

public interface ArchiveExtractorManager

Method Summary

Modifier and Type	Method	Description
void	extractFiles(File archive, ArchiveFileSelector selector)	Selects appropriate archive extractor and extracts files from given archive filtered by file selector.
default Map<String,Long>	getEntitiesSize(File archive)
default Map<String,Integer>	getEntitiesUnixPermissions(File archive)

Method Detail

extractFiles

void extractFiles(@NotNull
                  File archive,
                  @NotNull
                  ArchiveFileSelector selector)
           throws IOException,
                  UnsupportedArchiveTypeException

Selects appropriate archive extractor and extracts files from given archive filtered by file selector.

Parameters:

archive - archive to be processed

selector - selector for files within the archive

Throws:

IOException - Any I/O error occurred

UnsupportedArchiveTypeException - Archive has unsupported format

getEntitiesSize

default Map<String,Long> getEntitiesSize(@NotNull
                                               File archive)
                                        throws IOException,
                                               UnsupportedArchiveTypeException

Parameters:

archive - archive to be processed

Returns:

map of entities name to uncompressed size on this entry, same names which are used in ArchiveFileSelector will be used as keys, -1 as size may be returned if size is unknown

Throws:

IOException - Any I/O error occurred

UnsupportedArchiveTypeException - Archive has unsupported format

Since:

2022.10

getEntitiesUnixPermissions

default Map<String,Integer> getEntitiesUnixPermissions(@NotNull
                                                             File archive)
                                                      throws IOException,
                                                             UnsupportedArchiveTypeException

Parameters:

archive - archive to be processed

Returns:

map of entities name to an integer representation of Unix permissions for this entry, same names which are used in ArchiveFileSelector will be used as keys, empty map if unix permissions are not available in the map

Throws:

IOException - Error occurred during extraction

UnsupportedArchiveTypeException - Archive has unsupported format

Since:

2023.03