net.sf.antcontrib.logic

Class OutOfDate

public class OutOfDate extends Task implements Condition

Task to help in calling tasks if generated files are older than source files. Sets a given property or runs an internal task. Based on org.apache.org.apache.tools.ant.taskdefs.UpToDate

Author: peter reilly

Nested Class Summary
static classOutOfDate.CollectionEnum
Enumerated type for collection attribute
classOutOfDate.DeleteTargets
nested delete targets
static classOutOfDate.MyMapper
Wrapper for mapper - includes dir
Method Summary
voidaddParallel(Parallel doTask)
Embedded do parallel
voidaddSequential(Sequential doTask)
Embedded do sequential.
OutOfDate.DeleteTargetscreateDeleteTargets()
optional nested delete element
MappercreateMapper()
Defines the FileNameMapper to use (nested mapper element).
PathcreateSourcefiles()
Add to the source files
PathcreateTargetfiles()
Add to the target files
booleaneval()
Evaluate (all) target and source file(s) to see if the target(s) is/are outoutdate.
voidexecute()
Sets property to true and/or executes embedded do if any of the target file(s) do not have a more recent timestamp than (each of) the source file(s).
Iteratoriterator()
Call evalute and return an iterator over the result
voidsetAllTargets(String allTargets)
A property to contain all the target filenames
voidsetAllTargetsPath(String allTargetsPath)
A refernce to contain the path of all the targets
voidsetCollection(OutOfDate.CollectionEnum collection)
Set the collection attribute, controls what is returned by the iterator method.
voidsetForce(boolean force)
whether to allways be outofdate
voidsetOutputSources(String outputSources)
A property to contain the output source files
voidsetOutputSourcesPath(String outputSourcesPath)
A reference to the path containing all the sources files.
voidsetOutputTargets(String outputTargets)
A property to contain the output target files
voidsetOutputTargetsPath(String outputTargetsPath)
A reference to contain the path of target files that are outofdate
voidsetProperty(String property)
The property to set if any of the target files are outofdate with regard to any of the source files.
voidsetSeparator(String separator)
The separator to use to separate the files
voidsetValue(String value)
The value to set the named property to the target files are outofdate
voidsetVerbose(boolean verbose)
whether to have verbose output

Method Detail

addParallel

public void addParallel(Parallel doTask)
Embedded do parallel

Parameters: doTask the parallel to embed

addSequential

public void addSequential(Sequential doTask)
Embedded do sequential.

Parameters: doTask the sequential to embed

createDeleteTargets

public OutOfDate.DeleteTargets createDeleteTargets()
optional nested delete element

Returns: an element to be configured

createMapper

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

Returns: Mappper to be configured

createSourcefiles

public Path createSourcefiles()
Add to the source files

Returns: a path to be configured

createTargetfiles

public Path createTargetfiles()
Add to the target files

Returns: a path to be configured

eval

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

Returns: true if any of the targets are outofdate

execute

public void execute()
Sets property to true and/or executes embedded do if any of the target file(s) do not have a more recent timestamp than (each of) the source file(s).

iterator

public Iterator iterator()
Call evalute and return an iterator over the result

Returns: an iterator over the result

setAllTargets

public void setAllTargets(String allTargets)
A property to contain all the target filenames

Parameters: allTargets the name of the property

setAllTargetsPath

public void setAllTargetsPath(String allTargetsPath)
A refernce to contain the path of all the targets

Parameters: allTargetsPath the name of the reference

setCollection

public void setCollection(OutOfDate.CollectionEnum collection)
Set the collection attribute, controls what is returned by the iterator method.
  • "sources" the sources that are newer than the corresponding targets.
  • "targets" the targets that are older or not present than the corresponding sources.
  • "allsources" all the sources
  • "alltargets" all the targets
  • Parameters: collection "sources" the changes

    setForce

    public void setForce(boolean force)
    whether to allways be outofdate

    Parameters: force true means that outofdate is always set, default false

    setOutputSources

    public void setOutputSources(String outputSources)
    A property to contain the output source files

    Parameters: outputSources the name of the property

    setOutputSourcesPath

    public void setOutputSourcesPath(String outputSourcesPath)
    A reference to the path containing all the sources files.

    Parameters: outputSourcesPath the name of the reference

    setOutputTargets

    public void setOutputTargets(String outputTargets)
    A property to contain the output target files

    Parameters: outputTargets the name of the property

    setOutputTargetsPath

    public void setOutputTargetsPath(String outputTargetsPath)
    A reference to contain the path of target files that are outofdate

    Parameters: outputTargetsPath the name of the reference

    setProperty

    public void setProperty(String property)
    The property to set if any of the target files are outofdate with regard to any of the source files.

    Parameters: property the name of the property to set if Target is outofdate.

    setSeparator

    public void setSeparator(String separator)
    The separator to use to separate the files

    Parameters: separator separator used in outout properties

    setValue

    public void setValue(String value)
    The value to set the named property to the target files are outofdate

    Parameters: value the value to set the property

    setVerbose

    public void setVerbose(boolean verbose)
    whether to have verbose output

    Parameters: verbose true means that outofdate outputs debug info