Package org.codehaus.plexus.archiver.tar

Class TarArchiver

java.lang.Object

org.codehaus.plexus.archiver.AbstractArchiver

org.codehaus.plexus.archiver.tar.TarArchiver

All Implemented Interfaces:

Archiver, FinalizerEnabled

Direct Known Subclasses:

TarBZip2Archiver, TarGZipArchiver, TarSnappyArchiver, TarXZArchiver, TarZstdArchiver

@Named("tar")
public class TarArchiver
extends AbstractArchiver

Author:

Emmanuel Venisse

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	TarArchiver.TarCompressionMethod	Valid Modes for Compression attribute to Tar Task
class	TarArchiver.TarOptions	Valid Modes for Compression attribute to Tar Task

Field Summary

Fields inherited from interface org.codehaus.plexus.archiver.Archiver

DEFAULT_DIR_MODE, DEFAULT_FILE_MODE, DEFAULT_SYMLILNK_MODE, DUPLICATES_ADD, DUPLICATES_FAIL, DUPLICATES_PRESERVE, DUPLICATES_SKIP, DUPLICATES_VALID_BEHAVIORS

Constructor Summary

Constructors

Constructor	Description
TarArchiver()

Method Summary

Modifier and Type	Method	Description
protected void	cleanUp()
protected void	close()
protected void	execute()
protected String	getArchiveType()
boolean	isSupportingForced()	Returns, whether the archive supports uptodate checks.
void	setCompression(TarArchiver.TarCompressionMethod mode)	Set compression method.
void	setLongfile(TarLongFileMode mode)	Set how to handle long files, those with a path>100 chars.
protected void	tarFile(ArchiveEntry entry, org.apache.commons.compress.archivers.tar.TarArchiveOutputStream tOut, String vPath)	tar a file

Methods inherited from class org.codehaus.plexus.archiver.AbstractArchiver

addArchivedFileSet, addArchivedFileSet, addArchivedFileSet, addArchivedFileSet, addArchivedFileSet, addArchivedFileSet, addArchiveFinalizer, addDirectory, addDirectory, addDirectory, addDirectory, addFile, addFile, addFileSet, addResource, addResources, addSymlink, addSymlink, asArchiveEntry, asResourceCollection, checkForced, configureReproducible, configureReproducibleBuild, createArchive, getDefaultDirectoryMode, getDefaultFileMode, getDestFile, getDirectoryMode, getDuplicateBehavior, getFileMode, getFilenameComparator, getFiles, getIncludeEmptyDirs, getLastModifiedDate, getLastModifiedTime, getLogger, getOverrideDirectoryMode, getOverrideFileMode, getOverrideGid, getOverrideGroupName, getOverrideUid, getOverrideUserName, getRawDefaultFileMode, getResources, getUmask, hasVirtualFiles, isForced, isIgnorePermissions, isUptodate, isUseJvmChmod, normalizeLastModifiedTime, postCreateArchive, revert, runArchiveFinalizers, setArchiveFinalizers, setDefaultDirectoryMode, setDefaultFileMode, setDestFile, setDirectoryMode, setDotFileDirectory, setDuplicateBehavior, setFileMode, setFilenameComparator, setForced, setIgnorePermissions, setIncludeEmptyDirs, setLastModifiedDate, setLastModifiedTime, setOverrideGid, setOverrideGroupName, setOverrideUid, setOverrideUserName, setUmask, setUseJvmChmod, validate

Methods inherited from class java.lang.Object

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

Constructor Details

TarArchiver

public TarArchiver()

Method Details

setLongfile

public void setLongfile(TarLongFileMode mode)

Set how to handle long files, those with a path>100 chars. Optional, default=warn.

Allowable values are

• truncate - paths are truncated to the maximum length
• fail - paths greater than the maximum cause a build exception
• warn - paths greater than the maximum cause a warning and GNU is used
• gnu - GNU extensions are used for any paths greater than the maximum.
• posix - posix extensions are used for any paths greater than the maximum.
• posixwarn - posix extensions are used (with warning) for any paths greater than the maximum.
• omit - paths greater than the maximum are omitted from the archive

Parameters:

mode - the mode to handle long file names.

setCompression

public void setCompression(TarArchiver.TarCompressionMethod mode)

Set compression method. Allowable values are

• none - no compression
• gzip - Gzip compression
• bzip2 - Bzip2 compression

Parameters:

mode - the compression method.

execute

protected void execute()
                throws ArchiverException,
IOException

Specified by:

execute in class AbstractArchiver

Throws:

ArchiverException

IOException

tarFile

protected void tarFile(ArchiveEntry entry,
 org.apache.commons.compress.archivers.tar.TarArchiveOutputStream tOut,
 String vPath)
                throws ArchiverException,
IOException

tar a file

Parameters:

entry - the file to tar

tOut - the output stream

vPath - the path name of the file to tar

Throws:

IOException - on error

ArchiverException

isSupportingForced

public boolean isSupportingForced()

Description copied from interface: Archiver

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

Specified by:

isSupportingForced in interface Archiver

Overrides:

isSupportingForced in class AbstractArchiver

Returns:

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

See Also:

• Archiver.setForced(boolean)
• Archiver.isForced()

cleanUp

protected void cleanUp()
                throws IOException

Overrides:

cleanUp in class AbstractArchiver

Throws:

IOException

close

protected void close()
              throws IOException

Specified by:

close in class AbstractArchiver

Throws:

IOException

getArchiveType

protected String getArchiveType()

Specified by:

getArchiveType in class AbstractArchiver