Package org.codehaus.plexus.archiver.tar

Class TarArchiver

java.lang.Object

org.codehaus.plexus.logging.AbstractLogEnabled

org.codehaus.plexus.archiver.AbstractArchiver

org.codehaus.plexus.archiver.tar.TarArchiver

All Implemented Interfaces:

Archiver, FinalizerEnabled, org.codehaus.plexus.logging.LogEnabled, org.codehaus.plexus.personality.plexus.lifecycle.phase.Contextualizable

public class TarArchiver
extends AbstractArchiver

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

Modifier and Type	Field	Description
private TarArchiver.TarCompressionMethod	compression
private TarLongFileMode	longFileMode
private boolean	longWarningGiven	Indicates whether the user has been warned about long files already.
private TarArchiver.TarOptions	options
private org.apache.commons.compress.archivers.tar.TarArchiveOutputStream	tOut

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, ROLE

Constructor Summary

Constructors

Constructor	Description
TarArchiver()

Method Summary

Modifier and Type	Method	Description
protected void	cleanUp()
protected void	close()
private OutputStream	compress(TarArchiver.TarCompressionMethod tarCompressionMethod, OutputStream ostream)
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, contextualize, createArchive, getDefaultDirectoryMode, getDefaultFileMode, getDestFile, getDirectoryMode, getDuplicateBehavior, getFileMode, getFilenameComparator, getFiles, getIncludeEmptyDirs, getLastModifiedDate, getLogger, getOverrideDirectoryMode, getOverrideFileMode, getOverrideGid, getOverrideGroupName, getOverrideUid, getOverrideUserName, getRawDefaultFileMode, getResources, hasVirtualFiles, isForced, isIgnorePermissions, isUptodate, isUseJvmChmod, normalizeLastModifiedDate, postCreateArchive, revert, runArchiveFinalizers, setArchiveFinalizers, setDefaultDirectoryMode, setDefaultFileMode, setDestFile, setDirectoryMode, setDotFileDirectory, setDuplicateBehavior, setFileMode, setFilenameComparator, setForced, setIgnorePermissions, setIncludeEmptyDirs, setLastModifiedDate, setOverrideGid, setOverrideGroupName, setOverrideUid, setOverrideUserName, setUseJvmChmod, validate

Methods inherited from class org.codehaus.plexus.logging.AbstractLogEnabled

enableLogging, setupLogger, setupLogger, setupLogger

Methods inherited from class java.lang.Object

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

Field Details

longWarningGiven

private boolean longWarningGiven

Indicates whether the user has been warned about long files already.

longFileMode

private TarLongFileMode longFileMode

compression

private TarArchiver.TarCompressionMethod compression

options

private TarArchiver.TarOptions options

tOut

private org.apache.commons.compress.archivers.tar.TarArchiveOutputStream tOut

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

compress

private OutputStream compress(TarArchiver.TarCompressionMethod tarCompressionMethod,
 OutputStream ostream)
                       throws IOException

Throws:

IOException

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