Package org.apache.tools.ant.types
Class TarFileSet
- java.lang.Object
-
- All Implemented Interfaces:
java.lang.Cloneable,java.lang.Iterable<Resource>,ResourceCollection,SelectorContainer
- Direct Known Subclasses:
Tar.TarFileSet
public class TarFileSet extends ArchiveFileSet
A TarFileSet is a FileSet with extra attributes useful in the context of Tar/Jar tasks. A TarFileSet extends FileSets with the ability to extract a subset of the entries of a Tar file for inclusion in another Tar file. It also includes a prefix attribute which is prepended to each entry in the output Tar file.
-
-
Field Summary
-
Fields inherited from class org.apache.tools.ant.types.ArchiveFileSet
DEFAULT_DIR_MODE, DEFAULT_FILE_MODE
-
Fields inherited from class org.apache.tools.ant.ProjectComponent
description, location, project
-
-
Constructor Summary
Constructors Modifier Constructor Description TarFileSet()Constructor for TarFileSetprotectedTarFileSet(FileSet fileset)Constructor using a fileset argument.protectedTarFileSet(TarFileSet fileset)Constructor using a tarfileset argument.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description java.lang.Objectclone()Return a TarFileSet that has the same properties as this one.protected voidconfigureFileSet(ArchiveFileSet zfs)Configure a fileset based on this fileset.intgetGid()java.lang.StringgetGroup()protected AbstractFileSetgetRef()A TarFileset accepts another TarFileSet or a FileSet as reference FileSets are often used by the war task for the lib attributeprotected AbstractFileSetgetRef(Project p)A TarFileset accepts another TarFileSet or a FileSet as reference FileSets are often used by the war task for the lib attributeintgetUid()java.lang.StringgetUserName()booleanhasGroupBeenSet()booleanhasGroupIdBeenSet()booleanhasUserIdBeenSet()booleanhasUserNameBeenSet()protected ArchiveScannernewArchiveScanner()Create a new scanner.voidsetGid(int gid)The GID for the tar entry; optional, default="0" This is not the same as the group name.voidsetGroup(java.lang.String groupName)The groupname for the tar entry; optional, default="" This is not the same as the GID.voidsetRefid(Reference r)Makes this instance in effect a reference to another instance.voidsetUid(int uid)The uid for the tar entry This is not the same as the User name.voidsetUserName(java.lang.String userName)The username for the tar entry This is not the same as the UID.-
Methods inherited from class org.apache.tools.ant.types.ArchiveFileSet
addConfigured, dieOnCircularReference, getDirectoryScanner, getDirMode, getDirMode, getEncoding, getFileMode, getFileMode, getFullpath, getFullpath, getPrefix, getPrefix, getSrc, getSrc, hasDirModeBeenSet, hasFileModeBeenSet, integerSetDirMode, integerSetFileMode, isFilesystemOnly, iterator, setDir, setDirMode, setEncoding, setErrorOnMissingArchive, setFileMode, setFullpath, setPrefix, setSrc, setSrcResource, size, toString
-
Methods inherited from class org.apache.tools.ant.types.AbstractFileSet
add, addAnd, addContains, addContainsRegexp, addCustom, addDate, addDepend, addDepth, addDifferent, addExecutable, addFilename, addMajority, addModified, addNone, addNot, addOr, addOwnedBy, addPosixGroup, addPosixPermissions, addPresent, addReadable, addSelector, addSize, addSymlink, addType, addWritable, appendExcludes, appendIncludes, appendSelector, createExclude, createExcludesFile, createInclude, createIncludesFile, createPatternSet, getDefaultexcludes, getDir, getDir, getDirectoryScanner, getErrorOnMissingDir, getMaxLevelsOfSymlinks, getSelectors, hasPatterns, hasSelectors, isCaseSensitive, isFollowSymlinks, mergeExcludes, mergeIncludes, mergePatterns, selectorCount, selectorElements, setCaseSensitive, setDefaultexcludes, setErrorOnMissingDir, setExcludes, setExcludesfile, setFile, setFollowSymlinks, setIncludes, setIncludesfile, setMaxLevelsOfSymlinks, setupDirectoryScanner, setupDirectoryScanner
-
Methods inherited from class org.apache.tools.ant.types.DataType
checkAttributesAllowed, checkChildrenAllowed, circularReference, dieOnCircularReference, dieOnCircularReference, getCheckedRef, getCheckedRef, getCheckedRef, getCheckedRef, getCheckedRef, getDataTypeName, getRefid, invokeCircularReferenceCheck, isChecked, isReference, noChildrenAllowed, pushAndInvokeCircularReferenceCheck, setChecked, tooManyAttributes
-
Methods inherited from class org.apache.tools.ant.ProjectComponent
getDescription, getLocation, getProject, log, log, setDescription, setLocation, setProject
-
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface org.apache.tools.ant.types.ResourceCollection
isEmpty, stream
-
-
-
-
Constructor Detail
-
TarFileSet
public TarFileSet()
Constructor for TarFileSet
-
TarFileSet
protected TarFileSet(FileSet fileset)
Constructor using a fileset argument.- Parameters:
fileset- the fileset to use
-
TarFileSet
protected TarFileSet(TarFileSet fileset)
Constructor using a tarfileset argument.- Parameters:
fileset- the tarfileset to use
-
-
Method Detail
-
setUserName
public void setUserName(java.lang.String userName)
The username for the tar entry This is not the same as the UID.- Parameters:
userName- the user name for the tar entry.
-
getUserName
public java.lang.String getUserName()
- Returns:
- the user name for the tar entry
-
hasUserNameBeenSet
public boolean hasUserNameBeenSet()
- Returns:
- whether the user name has been explicitly set.
-
setUid
public void setUid(int uid)
The uid for the tar entry This is not the same as the User name.- Parameters:
uid- the id of the user for the tar entry.
-
getUid
public int getUid()
- Returns:
- the uid for the tar entry
-
hasUserIdBeenSet
public boolean hasUserIdBeenSet()
- Returns:
- whether the user id has been explicitly set.
-
setGroup
public void setGroup(java.lang.String groupName)
The groupname for the tar entry; optional, default="" This is not the same as the GID.- Parameters:
groupName- the group name string.
-
getGroup
public java.lang.String getGroup()
- Returns:
- the group name string.
-
hasGroupBeenSet
public boolean hasGroupBeenSet()
- Returns:
- whether the group name has been explicitly set.
-
setGid
public void setGid(int gid)
The GID for the tar entry; optional, default="0" This is not the same as the group name.- Parameters:
gid- the group id.
-
getGid
public int getGid()
- Returns:
- the group identifier.
-
hasGroupIdBeenSet
public boolean hasGroupIdBeenSet()
- Returns:
- whether the group id has been explicitly set.
-
newArchiveScanner
protected ArchiveScanner newArchiveScanner()
Create a new scanner.- Specified by:
newArchiveScannerin classArchiveFileSet- Returns:
- the created scanner.
-
setRefid
public void setRefid(Reference r) throws BuildException
Makes this instance in effect a reference to another instance.You must not set another attribute or nest elements inside this element if you make it a reference.
- Overrides:
setRefidin classAbstractFileSet- Parameters:
r- theReferenceto use.- Throws:
BuildException- on error
-
getRef
protected AbstractFileSet getRef(Project p)
A TarFileset accepts another TarFileSet or a FileSet as reference FileSets are often used by the war task for the lib attribute
-
getRef
protected AbstractFileSet getRef()
A TarFileset accepts another TarFileSet or a FileSet as reference FileSets are often used by the war task for the lib attribute- Overrides:
getRefin classArchiveFileSet- Returns:
- the abstract fileset instance
-
configureFileSet
protected void configureFileSet(ArchiveFileSet zfs)
Configure a fileset based on this fileset. If the fileset is a TarFileSet copy in the tarfileset specific attributes.- Overrides:
configureFileSetin classArchiveFileSet- Parameters:
zfs- the archive fileset to configure.
-
clone
public java.lang.Object clone()
Return a TarFileSet that has the same properties as this one.- Overrides:
clonein classArchiveFileSet- Returns:
- the cloned tarFileSet
-
-