net.sf.antcontrib.logic
Class OutOfDate

java.lang.Object
  org.apache.tools.ant.ProjectComponent
      org.apache.tools.ant.Task
          net.sf.antcontrib.logic.OutOfDate

All Implemented Interfaces:

org.apache.tools.ant.taskdefs.condition.Condition

public class OutOfDate
extends org.apache.tools.ant.Task
implements org.apache.tools.ant.taskdefs.condition.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 class	OutOfDate.CollectionEnum Enumerated type for collection attribute
class	OutOfDate.DeleteTargets nested delete targets
static class	OutOfDate.MyMapper Wrapper for mapper - includes dir

Field Summary

Fields inherited from class org.apache.tools.ant.Task

description, location, target, taskName, taskType, wrapper

Fields inherited from class org.apache.tools.ant.ProjectComponent

project

Constructor Summary

OutOfDate()

Method Summary

void	addParallel(org.apache.tools.ant.taskdefs.Parallel doTask) Embedded do parallel
void	addSequential(org.apache.tools.ant.taskdefs.Sequential doTask) Embedded do sequential.
OutOfDate.DeleteTargets	createDeleteTargets() optional nested delete element
org.apache.tools.ant.types.Mapper	createMapper() Defines the FileNameMapper to use (nested mapper element).
org.apache.tools.ant.types.Path	createSourcefiles() Add to the source files
org.apache.tools.ant.types.Path	createTargetfiles() Add to the target files
boolean	eval() Evaluate (all) target and source file(s) to see if the target(s) is/are outoutdate.
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).
java.util.Iterator	iterator() Call evalute and return an iterator over the result
void	setAllTargets(java.lang.String allTargets) A property to contain all the target filenames
void	setAllTargetsPath(java.lang.String allTargetsPath) A refernce to contain the path of all the targets
void	setCollection(OutOfDate.CollectionEnum collection) Set the collection attribute, controls what is returned by the iterator method.
void	setForce(boolean force) whether to allways be outofdate
void	setOutputSources(java.lang.String outputSources) A property to contain the output source files
void	setOutputSourcesPath(java.lang.String outputSourcesPath) A reference to the path containing all the sources files.
void	setOutputTargets(java.lang.String outputTargets) A property to contain the output target files
void	setOutputTargetsPath(java.lang.String outputTargetsPath) A reference to contain the path of target files that are outofdate
void	setProperty(java.lang.String property) The property to set if any of the target files are outofdate with regard to any of the source files.
void	setSeparator(java.lang.String separator) The separator to use to separate the files
void	setValue(java.lang.String value) The value to set the named property to the target files are outofdate
void	setVerbose(boolean verbose) whether to have verbose output

Methods inherited from class org.apache.tools.ant.Task

getDescription, getLocation, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, init, isInvalid, log, log, maybeConfigure, perform, reconfigure, setDescription, setLocation, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType

Methods inherited from class org.apache.tools.ant.ProjectComponent

getProject, setProject

Methods inherited from class java.lang.Object

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

Constructor Detail

OutOfDate

public OutOfDate()

Method Detail

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

createMapper

public org.apache.tools.ant.types.Mapper createMapper()

Defines the FileNameMapper to use (nested mapper element).

Returns:

Mappper to be configured

setProperty

public void setProperty(java.lang.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(java.lang.String separator)

The separator to use to separate the files

Parameters:

separator - separator used in outout properties

setValue

public void setValue(java.lang.String value)

The value to set the named property to the target files are outofdate

Parameters:

value - the value to set the property

setForce

public void setForce(boolean force)

whether to allways be outofdate

Parameters:

force - true means that outofdate is always set, default false

setVerbose

public void setVerbose(boolean verbose)

whether to have verbose output

Parameters:

verbose - true means that outofdate outputs debug info

createTargetfiles

public org.apache.tools.ant.types.Path createTargetfiles()

Add to the target files

Returns:

a path to be configured

createSourcefiles

public org.apache.tools.ant.types.Path createSourcefiles()

Add to the source files

Returns:

a path to be configured

setOutputSources

public void setOutputSources(java.lang.String outputSources)

A property to contain the output source files

Parameters:

outputSources - the name of the property

setOutputTargets

public void setOutputTargets(java.lang.String outputTargets)

A property to contain the output target files

Parameters:

outputTargets - the name of the property

setOutputTargetsPath

public void setOutputTargetsPath(java.lang.String outputTargetsPath)

A reference to contain the path of target files that are outofdate

Parameters:

outputTargetsPath - the name of the reference

setAllTargetsPath

public void setAllTargetsPath(java.lang.String allTargetsPath)

A refernce to contain the path of all the targets

Parameters:

allTargetsPath - the name of the reference

setAllTargets

public void setAllTargets(java.lang.String allTargets)

A property to contain all the target filenames

Parameters:

allTargets - the name of the property

setOutputSourcesPath

public void setOutputSourcesPath(java.lang.String outputSourcesPath)

A reference to the path containing all the sources files.

Parameters:

outputSourcesPath - the name of the reference

createDeleteTargets

public OutOfDate.DeleteTargets createDeleteTargets()

optional nested delete element

Returns:

an element to be configured

addParallel

public void addParallel(org.apache.tools.ant.taskdefs.Parallel doTask)

Embedded do parallel

Parameters:

doTask - the parallel to embed

addSequential

public void addSequential(org.apache.tools.ant.taskdefs.Sequential doTask)

Embedded do sequential.

Parameters:

doTask - the sequential to embed

eval

public boolean eval()

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

Specified by:

eval in interface org.apache.tools.ant.taskdefs.condition.Condition

Returns:

true if any of the targets are outofdate

iterator

public java.util.Iterator iterator()

Call evalute and return an iterator over the result

Returns:

an iterator over the result

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).

Overrides:

execute in class org.apache.tools.ant.Task