org.apache.tools.ant.taskdefs

Class UpToDate

public class UpToDate extends Task implements Condition

Sets the given property if the specified target has a timestamp greater than all of the source files.

Since: Ant 1.2

UNKNOWN: category="control"

Field Summary
protected MappermapperElement
Method Summary
voidadd(FileNameMapper fileNameMapper)
A nested filenamemapper
voidaddSrcfiles(FileSet fs)
Nested <srcfiles> element.
MappercreateMapper()
Defines the FileNameMapper to use (nested mapper element).
booleaneval()
Evaluate (all) target and source file(s) to see if the target(s) is/are up-to-date.
voidexecute()
Sets property to true if target file(s) have a more recent timestamp than (each of) the corresponding source file(s).
protected booleanscanDir(File srcDir, String[] files)
Scan a directory for files to check for "up to date"ness
voidsetProperty(String property)
The property to set if the target file is more up-to-date than (each of) the source file(s).
voidsetSrcfile(File file)
The file that must be older than the target file if the property is to be set.
voidsetTargetFile(File file)
The file which must be more up-to-date than (each of) the source file(s) if the property is to be set.
voidsetValue(String value)
The value to set the named property to if the target file is more up-to-date than (each of) the source file(s).

Field Detail

mapperElement

protected Mapper mapperElement

Method Detail

add

public void add(FileNameMapper fileNameMapper)
A nested filenamemapper

Parameters: fileNameMapper the mapper to add

Since: Ant 1.6.3

addSrcfiles

public void addSrcfiles(FileSet fs)
Nested <srcfiles> element.

Parameters: fs the source files

createMapper

public Mapper createMapper()
Defines the FileNameMapper to use (nested mapper element).

Returns: a mapper to be configured

Throws: BuildException if more than one mapper is defined

eval

public boolean eval()
Evaluate (all) target and source file(s) to see if the target(s) is/are up-to-date.

Returns: true if the target(s) is/are up-to-date

execute

public void execute()
Sets property to true if target file(s) have a more recent timestamp than (each of) the corresponding source file(s).

Throws: BuildException on error

scanDir

protected boolean scanDir(File srcDir, String[] files)
Scan a directory for files to check for "up to date"ness

Parameters: srcDir the directory files the files to scan for

Returns: true if the files are up to date

setProperty

public void setProperty(String property)
The property to set if the target file is more up-to-date than (each of) the source file(s).

Parameters: property the name of the property to set if Target is up-to-date.

setSrcfile

public void setSrcfile(File file)
The file that must be older than the target file if the property is to be set.

Parameters: file the file we are checking against the target file.

setTargetFile

public void setTargetFile(File file)
The file which must be more up-to-date than (each of) the source file(s) if the property is to be set.

Parameters: file the file we are checking against.

setValue

public void setValue(String value)
The value to set the named property to if the target file is more up-to-date than (each of) the source file(s). Defaults to 'true'.

Parameters: value the value to set the property to if Target is up-to-date

Copyright B) 2000-2007 Apache Software Foundation. All Rights Reserved.