org.apache.tools.ant.taskdefs

Class CopyPath

public class CopyPath extends Task

Deprecated: this task should have never been released and was obsoleted by ResourceCollection support in Copy available since Ant 1.7.0. Don't use it.

Copy the contents of a path to a destination, using the mapper of choice

Since: Ant 1.7.0

UNKNOWN: category="filesystem"

Field Summary
static StringERROR_NO_DESTDIR
No destdir attribute
static StringERROR_NO_MAPPER
No mapper
static StringERROR_NO_PATH
No path
Method Summary
voidadd(FileNameMapper newmapper)
add a mapper
PathcreatePath()
Create a path.
voidexecute()
This is a very minimal derivative of the nomal copy logic.
voidsetDestDir(File destDir)
The dest dir attribute.
voidsetGranularity(long granularity)
Set the number of milliseconds leeway to give before deciding a target is out of date.
voidsetPath(Path s)
Set the path to be used when running the Java class.
voidsetPathRef(Reference r)
Set the path to use by reference.
voidsetPreserveLastModified(boolean preserveLastModified)
Give the copied files the same last modified time as the original files.
protected voidvalidateAttributes()
Ensure we have a consistent and legal set of attributes, and set any internal flags necessary based on different combinations of attributes.

Field Detail

ERROR_NO_DESTDIR

public static final String ERROR_NO_DESTDIR
No destdir attribute

ERROR_NO_MAPPER

public static final String ERROR_NO_MAPPER
No mapper

ERROR_NO_PATH

public static final String ERROR_NO_PATH
No path

Method Detail

add

public void add(FileNameMapper newmapper)
add a mapper

Parameters: newmapper the mapper to add.

createPath

public Path createPath()
Create a path.

Returns: a path to be configured.

execute

public void execute()
This is a very minimal derivative of the nomal copy logic.

Throws: BuildException if something goes wrong with the build.

setDestDir

public void setDestDir(File destDir)
The dest dir attribute.

Parameters: destDir the value of the destdir attribute.

setGranularity

public void setGranularity(long granularity)
Set the number of milliseconds leeway to give before deciding a target is out of date. TODO: This is not yet used.

Parameters: granularity the granularity used to decide if a target is out of date.

setPath

public void setPath(Path s)
Set the path to be used when running the Java class.

Parameters: s an Ant Path object containing the path.

setPathRef

public void setPathRef(Reference r)
Set the path to use by reference.

Parameters: r a reference to an existing path.

setPreserveLastModified

public void setPreserveLastModified(boolean preserveLastModified)
Give the copied files the same last modified time as the original files.

Parameters: preserveLastModified if true preserve the modified time; default is false.

validateAttributes

protected void validateAttributes()
Ensure we have a consistent and legal set of attributes, and set any internal flags necessary based on different combinations of attributes.

Throws: BuildException if an error occurs.