Package org.codehaus.plexus.archiver

Interface Archiver

All Known Implementing Classes:

AbstractArchiver, AbstractZipArchiver, BZip2Archiver, DelgatingArchiver, DirectoryArchiver, DryRunArchiver, EarArchiver, GZipArchiver, JarArchiver, JarToolModularJarArchiver, ModularJarArchiver, NoOpArchiver, RarArchiver, SnappyArchiver, TarArchiver, TrackingArchiver, WarArchiver, XZArchiver, ZipArchiver

public interface Archiver

Field Summary

Fields

Modifier and Type	Field	Description
static final int	DEFAULT_DIR_MODE	Default value for the dirmode attribute.
static final int	DEFAULT_FILE_MODE	Default value for the filemode attribute.
static final int	DEFAULT_SYMLILNK_MODE	Default value for the symlinkmode attribute.
static final String	DUPLICATES_ADD
static final String	DUPLICATES_FAIL
static final String	DUPLICATES_PRESERVE
static final String	DUPLICATES_SKIP
static final Set<String>	DUPLICATES_VALID_BEHAVIORS

Method Summary

Modifier and Type	Method	Description
void	addArchivedFileSet(File archiveFile)	Deprecated. Will go away in next major version
void	addArchivedFileSet(File archiveFile, String prefix)	Deprecated. Will go away in next major version
void	addArchivedFileSet(File archiveFile, String[] includes, String[] excludes)	Deprecated. Will go away in next major version
void	addArchivedFileSet(File archiveFile, String prefix, String[] includes, String[] excludes)	Deprecated. Will go away in next major version
void	addArchivedFileSet(ArchivedFileSet fileSet)	Adds the given archive file set to the archive.
void	addArchivedFileSet(ArchivedFileSet fileSet, Charset charset)	Adds the given archive file set to the archive.
void	addDirectory(File directory)	Deprecated. Will go away in next major version
void	addDirectory(File directory, String prefix)	Deprecated. Will go away in next major version
void	addDirectory(File directory, String[] includes, String[] excludes)	Deprecated. Will go away in next major version
void	addDirectory(File directory, String prefix, String[] includes, String[] excludes)	Deprecated. Will go away in next major version
void	addFile(File inputFile, String destFileName)
void	addFile(File inputFile, String destFileName, int permissions)
void	addFileSet(FileSet fileSet)	Adds the given file set to the archive.
void	addResource(org.codehaus.plexus.components.io.resources.PlexusIoResource resource, String destFileName, int permissions)	Adds the given resource collection to the archive.
void	addResources(org.codehaus.plexus.components.io.resources.PlexusIoResourceCollection resources)	Adds the given resource collection to the archive.
void	addSymlink(String symlinkName, int permissions, String symlinkDestination)
void	addSymlink(String symlinkName, String symlinkDestination)
void	configureReproducible(Date lastModifiedDate)	Deprecated. Use configureReproducibleBuild(FileTime) instead.
void	configureReproducibleBuild(FileTime lastModifiedTime)	Configure the archiver to create archives in a reproducible way (see Reproducible Builds).
void	createArchive()
int	getDefaultDirectoryMode()
int	getDefaultFileMode()
File	getDestFile()
int	getDirectoryMode()	Gets the forced mode for directories, falling back to default if none is forced.
String	getDuplicateBehavior()	Returns the behavior of this archiver when duplicate files are detected.
int	getFileMode()
Map<String,ArchiveEntry>	getFiles()	Deprecated. Use getResources()
boolean	getIncludeEmptyDirs()
Date	getLastModifiedDate()	Deprecated. Use getLastModifiedTime() instead
FileTime	getLastModifiedTime()	Returns the last modification time of the archiver.
int	getOverrideDirectoryMode()
int	getOverrideFileMode()
int	getOverrideGid()
String	getOverrideGroupName()
int	getOverrideUid()
String	getOverrideUserName()
ResourceIterator	getResources()	Returns an iterator over instances of ArchiveEntry, which have previously been added by calls to addResources(PlexusIoResourceCollection), addResource(PlexusIoResource, String, int), addFileSet(FileSet), etc.
boolean	isForced()	Returns, whether recreating the archive is forced (default).
boolean	isIgnorePermissions()
boolean	isSupportingForced()	Returns, whether the archive supports uptodate checks.
boolean	isUseJvmChmod()	Deprecated. this setting is now ignored.
void	setDefaultDirectoryMode(int mode)	This is the "default" value we should use if no other value is specified
void	setDefaultFileMode(int mode)
void	setDestFile(File destFile)
void	setDirectoryMode(int mode)	This is the forced mode that should be used regardless if set, otherwise falls back to default.
void	setDotFileDirectory(File dotFileDirectory)
void	setDuplicateBehavior(String duplicate)	Set the behavior of this archiver when duplicate files are detected.
void	setFileMode(int mode)
void	setFilenameComparator(Comparator<String> filenameComparator)	Set filename comparator, used to sort file entries when scanning directories since File.list() does not guarantee any order.
void	setForced(boolean forced)	Sets, whether recreating the archive is forced (default).
void	setIgnorePermissions(boolean ignorePermissions)
void	setIncludeEmptyDirs(boolean includeEmptyDirs)
void	setLastModifiedDate(Date lastModifiedDate)	Deprecated. Use setLastModifiedTime(FileTime) instead
void	setLastModifiedTime(FileTime lastModifiedTime)	Sets the last modification time of the entries (if non null).
void	setOverrideGid(int gid)
void	setOverrideGroupName(String groupName)
void	setOverrideUid(int uid)
void	setOverrideUserName(String userName)
void	setUseJvmChmod(boolean useJvmChmod)	Deprecated. this setting is now ignored.

Field Details

DEFAULT_DIR_MODE

static final int DEFAULT_DIR_MODE

Default value for the dirmode attribute.

See Also:

• Constant Field Values

DEFAULT_FILE_MODE

static final int DEFAULT_FILE_MODE

Default value for the filemode attribute.

See Also:

• Constant Field Values

DEFAULT_SYMLILNK_MODE

static final int DEFAULT_SYMLILNK_MODE

Default value for the symlinkmode attribute.

See Also:

• Constant Field Values

DUPLICATES_ADD

static final String DUPLICATES_ADD

See Also:

• Constant Field Values

DUPLICATES_PRESERVE

static final String DUPLICATES_PRESERVE

See Also:

• Constant Field Values

DUPLICATES_SKIP

static final String DUPLICATES_SKIP

See Also:

• Constant Field Values

DUPLICATES_FAIL

static final String DUPLICATES_FAIL

See Also:

• Constant Field Values

DUPLICATES_VALID_BEHAVIORS

static final Set<String> DUPLICATES_VALID_BEHAVIORS

Method Details

createArchive

void createArchive()
            throws ArchiverException,
IOException

Throws:

ArchiverException

IOException

addDirectory

@Deprecated
void addDirectory(@Nonnull
 File directory)
           throws ArchiverException

Deprecated.

Will go away in next major version

Obsolete, use addFileSet(FileSet).

Throws:

ArchiverException

addDirectory

@Deprecated
void addDirectory(@Nonnull
 File directory,
 String prefix)
           throws ArchiverException

Deprecated.

Will go away in next major version

Obsolete, use addFileSet(FileSet).

Throws:

ArchiverException

addDirectory

@Deprecated
void addDirectory(@Nonnull
 File directory,
 String[] includes,
 String[] excludes)
           throws ArchiverException

Deprecated.

Will go away in next major version

Obsolete, use addFileSet(FileSet).

Throws:

ArchiverException

addDirectory

@Deprecated
void addDirectory(@Nonnull
 File directory,
 String prefix,
 String[] includes,
 String[] excludes)
           throws ArchiverException

Deprecated.

Will go away in next major version

Obsolete, use addFileSet(FileSet).

Throws:

ArchiverException

addFileSet

void addFileSet(@Nonnull
 FileSet fileSet)
         throws ArchiverException

Adds the given file set to the archive. This method is basically obsoleting addDirectory(File), addDirectory(File, String), addDirectory(File, String[], String[]), and addDirectory(File, String, String[], String[]). However, as these methods are in widespread use, they cannot easily be deprecated.

Throws:

ArchiverException - Adding the file set failed.

Since:

1.0-alpha-9

addSymlink

void addSymlink(String symlinkName,
 String symlinkDestination)
         throws ArchiverException

Throws:

ArchiverException

addSymlink

void addSymlink(String symlinkName,
 int permissions,
 String symlinkDestination)
         throws ArchiverException

Throws:

ArchiverException

addFile

void addFile(@Nonnull
 File inputFile,
 @Nonnull
 String destFileName)
      throws ArchiverException

Throws:

ArchiverException

addFile

void addFile(@Nonnull
 File inputFile,
 @Nonnull
 String destFileName,
 int permissions)
      throws ArchiverException

Throws:

ArchiverException

addArchivedFileSet

void addArchivedFileSet(@Nonnull
 File archiveFile)
                 throws ArchiverException

Deprecated.

Will go away in next major version

Obsolete, use addArchivedFileSet(ArchivedFileSet).

Throws:

ArchiverException

addArchivedFileSet

@Deprecated
void addArchivedFileSet(@Nonnull
 File archiveFile,
 String prefix)
                 throws ArchiverException

Deprecated.

Will go away in next major version

Obsolete, use addArchivedFileSet(ArchivedFileSet).

Throws:

ArchiverException

addArchivedFileSet

@Deprecated
void addArchivedFileSet(File archiveFile,
 String[] includes,
 String[] excludes)
                 throws ArchiverException

Deprecated.

Will go away in next major version

Obsolete, use addArchivedFileSet(ArchivedFileSet).

Throws:

ArchiverException

addArchivedFileSet

@Deprecated
void addArchivedFileSet(@Nonnull
 File archiveFile,
 String prefix,
 String[] includes,
 String[] excludes)
                 throws ArchiverException

Deprecated.

Will go away in next major version

Obsolete, use addArchivedFileSet(ArchivedFileSet).

Throws:

ArchiverException

addArchivedFileSet

void addArchivedFileSet(ArchivedFileSet fileSet)
                 throws ArchiverException

Adds the given archive file set to the archive. This method is basically obsoleting addArchivedFileSet(File), addArchivedFileSet(File, String[], String[]), and addArchivedFileSet(File, String, String[], String[]). However, as these methods are in widespread use, they cannot easily be deprecated. Stream transformers are supported on this method

Throws:

ArchiverException

Since:

1.0-alpha-9

addArchivedFileSet

void addArchivedFileSet(ArchivedFileSet fileSet,
 Charset charset)
                 throws ArchiverException

Adds the given archive file set to the archive. This method is basically obsoleting addArchivedFileSet(File), addArchivedFileSet(File, String[], String[]), and addArchivedFileSet(File, String, String[], String[]). However, as these methods are in widespread use, they cannot easily be deprecated.

Parameters:

charset - the encoding to use, particularly useful to specific non-standard filename encodings for some kinds of archives (for instance zip files) Stream transformers are supported on this method

fileSet - the fileSet to add

charset -

Throws:

ArchiverException

Since:

1.0-alpha-9

addResource

void addResource(org.codehaus.plexus.components.io.resources.PlexusIoResource resource,
 String destFileName,
 int permissions)
          throws ArchiverException

Adds the given resource collection to the archive. Stream transformers are *not* supported on this method

Throws:

ArchiverException

Since:

1.0-alpha-10

addResources

void addResources(org.codehaus.plexus.components.io.resources.PlexusIoResourceCollection resources)
           throws ArchiverException

Adds the given resource collection to the archive. Stream transformers are supported on this method

Throws:

ArchiverException

Since:

1.0-alpha-10

getDestFile

File getDestFile()

setDestFile

void setDestFile(File destFile)

setFileMode

void setFileMode(int mode)

getFileMode

int getFileMode()

getOverrideFileMode

int getOverrideFileMode()

setDefaultFileMode

void setDefaultFileMode(int mode)

getDefaultFileMode

int getDefaultFileMode()

setDirectoryMode

void setDirectoryMode(int mode)

This is the forced mode that should be used regardless if set, otherwise falls back to default.

Parameters:

mode -

getDirectoryMode

int getDirectoryMode()

Gets the forced mode for directories, falling back to default if none is forced.

Returns:

getOverrideDirectoryMode

int getOverrideDirectoryMode()

setDefaultDirectoryMode

void setDefaultDirectoryMode(int mode)

This is the "default" value we should use if no other value is specified

Parameters:

mode -

getDefaultDirectoryMode

int getDefaultDirectoryMode()

getIncludeEmptyDirs

boolean getIncludeEmptyDirs()

setIncludeEmptyDirs

void setIncludeEmptyDirs(boolean includeEmptyDirs)

setDotFileDirectory

void setDotFileDirectory(File dotFileDirectory)

getResources

@Nonnull
ResourceIterator getResources()
                       throws ArchiverException

Returns an iterator over instances of ArchiveEntry, which have previously been added by calls to addResources(PlexusIoResourceCollection), addResource(PlexusIoResource, String, int), addFileSet(FileSet), etc.

Throws:

ArchiverException

Since:

1.0-alpha-10

getFiles

Map<String,ArchiveEntry> getFiles()

Deprecated.

Use getResources()

isForced

boolean isForced()

Returns, whether recreating the archive is forced (default). Setting this option to false means, that the archiver should compare the timestamps of included files with the timestamp of the target archive and rebuild the archive only, if the latter timestamp precedes the former timestamps. Checking for timestamps will typically offer a performance gain (in particular, if the following steps in a build can be suppressed, if an archive isn't recreated) on the cost that you get inaccurate results from time to time. In particular, removal of source files won't be detected.

An archiver doesn't necessarily support checks for uptodate. If so, setting this option to true will simply be ignored. The method isSupportingForced() may be called to check whether an archiver does support uptodate checks.

Returns:

true if the target archive should always be created; false otherwise

See Also:

• setForced(boolean)
• isSupportingForced()

setForced

void setForced(boolean forced)

Sets, whether recreating the archive is forced (default). Setting this option to false means, that the archiver should compare the timestamps of included files with the timestamp of the target archive and rebuild the archive only, if the latter timestamp precedes the former timestamps. Checking for timestamps will typically offer a performance gain (in particular, if the following steps in a build can be suppressed, if an archive isn't recreated) on the cost that you get inaccurate results from time to time. In particular, removal of source files won't be detected.

An archiver doesn't necessarily support checks for uptodate. If so, setting this option to true will simply be ignored. The method isSupportingForced() may be called to check whether an archiver does support uptodate checks.

Parameters:

forced - true, if the target archive should always be created; false otherwise

See Also:

• isForced()
• isSupportingForced()

isSupportingForced

boolean isSupportingForced()

Returns, whether the archive supports uptodate checks. If so, you may set setForced(boolean) to true.

Returns:

true, if the archiver does support uptodate checks, false otherwise

See Also:

• setForced(boolean)
• isForced()

getDuplicateBehavior

String getDuplicateBehavior()

Returns the behavior of this archiver when duplicate files are detected.

setDuplicateBehavior

void setDuplicateBehavior(String duplicate)

Set the behavior of this archiver when duplicate files are detected. One of:

• add - Add the duplicates to the archive as duplicate entries
• skip/preserve - Leave the first entry encountered in the archive, skip the new one
• fail - throw an ArchiverException

See DUPLICATES_ADD, DUPLICATES_SKIP, DUPLICATES_PRESERVE, DUPLICATES_FAIL.

setUseJvmChmod

@Deprecated
void setUseJvmChmod(boolean useJvmChmod)

Deprecated.

this setting is now ignored. The jvm is always used.

to use or not the jvm method for file permissions: user all not active for group permissions

Parameters:

useJvmChmod -

Since:

1.1

isUseJvmChmod

@Deprecated
boolean isUseJvmChmod()

Deprecated.

this setting is now ignored. The jvm is always used.

Returns:

Since:

1.1

isIgnorePermissions

boolean isIgnorePermissions()

Since:

1.1

setIgnorePermissions

void setIgnorePermissions(boolean ignorePermissions)

Since:

1.1

setLastModifiedDate

@Deprecated
void setLastModifiedDate(Date lastModifiedDate)

Deprecated.

Use setLastModifiedTime(FileTime) instead

Define forced last modification date for entries (if non null).

Parameters:

lastModifiedDate -

Since:

4.2.0

getLastModifiedDate

@Deprecated
Date getLastModifiedDate()

Deprecated.

Use getLastModifiedTime() instead

Since:

4.2.0

setLastModifiedTime

void setLastModifiedTime(FileTime lastModifiedTime)

Sets the last modification time of the entries (if non null).

Parameters:

lastModifiedTime - to set in the archive entries

Since:

4.3.0

See Also:

• getLastModifiedTime()

getLastModifiedTime

FileTime getLastModifiedTime()

Returns the last modification time of the archiver.

Returns:

The last modification time of the archiver, null if not specified

Since:

4.3.0

See Also:

• setLastModifiedTime(FileTime)

setFilenameComparator

void setFilenameComparator(Comparator<String> filenameComparator)

Set filename comparator, used to sort file entries when scanning directories since File.list() does not guarantee any order.

Since:

4.2.0

setOverrideUid

void setOverrideUid(int uid)

Since:

4.2.0

setOverrideUserName

void setOverrideUserName(String userName)

Since:

4.2.0

getOverrideUid

int getOverrideUid()

Since:

4.2.0

getOverrideUserName

String getOverrideUserName()

Since:

4.2.0

setOverrideGid

void setOverrideGid(int gid)

Since:

4.2.0

setOverrideGroupName

void setOverrideGroupName(String groupName)

Since:

4.2.0

getOverrideGid

int getOverrideGid()

Since:

4.2.0

getOverrideGroupName

String getOverrideGroupName()

Since:

4.2.0

configureReproducible

@Deprecated
void configureReproducible(Date lastModifiedDate)

Deprecated.

Use configureReproducibleBuild(FileTime) instead.

This method is obsolete and will just call configureReproducibleBuild(FileTime) with the Date transformed into FileTime.

Parameters:

lastModifiedDate - the date to use for archive entries last modified time

Since:

4.2.0

configureReproducibleBuild

void configureReproducibleBuild(FileTime lastModifiedTime)

Configure the archiver to create archives in a reproducible way (see Reproducible Builds).

This will configure:

• reproducible archive entries order,
• defined entries timestamp
• and reproducible entries Unix mode.

Parameters:

lastModifiedTime - The last modification time of the entries

Since:

4.3.0

See Also:

• Reproducible Builds