Package org.apache.tools.ant.taskdefs
Class Touch
java.lang.Object
org.apache.tools.ant.ProjectComponent
org.apache.tools.ant.Task
org.apache.tools.ant.taskdefs.Touch
- All Implemented Interfaces:
- Cloneable
Touch a file and/or fileset(s) and/or filelist(s);
 corresponds to the Unix touch command.
 
If the file to touch doesn't exist, an empty one is created.
- Since:
- Ant 1.1
- 
Nested Class SummaryNested Classes
- 
Field SummaryFieldsModifier and TypeFieldDescriptionstatic final Touch.DateFormatFactoryProvides access to DateUtils.EN_US_DATE_FORMAT_MIN (primary) and DateUtils.EN_US_DATE_FORMAT_SEC (fallback).Fields inherited from class org.apache.tools.ant.ProjectComponentdescription, location, project
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptionvoidAdd a collection of resources to touch.voidadd(FileNameMapper fileNameMapper) Add aFileNameMapper.voidaddConfiguredMapper(Mapper mapper) Add aMapper.voidaddFilelist(FileList list) Add a filelist to touch.voidaddFileset(FileSet set) Add a set of files to touch.protected voidCheck that this task has been configured properly.voidexecute()Execute the touch operation.voidsetDatetime(String dateTime) Set the new modification time of file(s) touched in the format "MM/DD/YYYY HH:MM AM or PM" or "MM/DD/YYYY HH:MM:SS AM or PM".voidSets a single source file to touch.voidsetMillis(long millis) Set the new modification time of file(s) touched in milliseconds since midnight Jan 1 1970.voidsetMkdirs(boolean mkdirs) Set whether nonexistent parent directories should be created when touching new files.voidsetPattern(String pattern) Set the format of the datetime attribute.voidsetVerbose(boolean verbose) Set whether the touch task will report every file it creates; defaults totrue.protected voidtouch()Does the actual work; assumes everything has been checked by now.protected voidDeprecated.since 1.6.x.Methods inherited from class org.apache.tools.ant.TaskbindToOwner, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, init, isInvalid, log, log, log, log, maybeConfigure, perform, reconfigure, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskTypeMethods inherited from class org.apache.tools.ant.ProjectComponentclone, getDescription, getLocation, getProject, setDescription, setLocation, setProject
- 
Field Details- 
DEFAULT_DF_FACTORYProvides access to DateUtils.EN_US_DATE_FORMAT_MIN (primary) and DateUtils.EN_US_DATE_FORMAT_SEC (fallback).
 
- 
- 
Constructor Details- 
Touchpublic Touch()
 
- 
- 
Method Details- 
setFileSets a single source file to touch. If the file does not exist an empty file will be created.- Parameters:
- file- the- Fileto touch.
 
- 
setMillispublic void setMillis(long millis) Set the new modification time of file(s) touched in milliseconds since midnight Jan 1 1970. Optional, default=now.- Parameters:
- millis- the- longtimestamp to use.
 
- 
setDatetimeSet the new modification time of file(s) touched in the format "MM/DD/YYYY HH:MM AM or PM" or "MM/DD/YYYY HH:MM:SS AM or PM". Optional, default=now.- Parameters:
- dateTime- the- Stringdate in the specified format.
 
- 
setMkdirspublic void setMkdirs(boolean mkdirs) Set whether nonexistent parent directories should be created when touching new files.- Parameters:
- mkdirs-- booleanwhether to create parent directories.
- Since:
- Ant 1.6.3
 
- 
setVerbosepublic void setVerbose(boolean verbose) Set whether the touch task will report every file it creates; defaults totrue.- Parameters:
- verbose-- booleanflag.
- Since:
- Ant 1.6.3
 
- 
setPatternSet the format of the datetime attribute.- Parameters:
- pattern- the- SimpleDateFormat-compatible format pattern.
- Since:
- Ant 1.6.3
 
- 
addConfiguredMapperAdd aMapper.- Parameters:
- mapper- the- Mapperto add.
- Since:
- Ant 1.6.3
 
- 
addAdd aFileNameMapper.- Parameters:
- fileNameMapper- the- FileNameMapperto add.
- Throws:
- BuildException- if multiple mappers are added.
- Since:
- Ant 1.6.3
 
- 
addFilesetAdd a set of files to touch.- Parameters:
- set- the- Filesetto add.
 
- 
addFilelistAdd a filelist to touch.- Parameters:
- list- the- Filelistto add.
 
- 
addAdd a collection of resources to touch.- Parameters:
- rc- the collection to add.
- Since:
- Ant 1.7
 
- 
checkConfigurationCheck that this task has been configured properly.- Throws:
- BuildException- if configuration errors are detected.
- Since:
- Ant 1.6.3
 
- 
executeExecute the touch operation.- Overrides:
- executein class- Task
- Throws:
- BuildException- if an error occurs.
 
- 
touchDoes the actual work; assumes everything has been checked by now.- Throws:
- BuildException- if an error occurs.
 
- 
touchDeprecated.since 1.6.x.Touch a single file with the current timestamp (this.millis). This method does not interact with any nested mappers and remains for reasons of backwards-compatibility only.- Parameters:
- file- file to touch
- Throws:
- BuildException- on error
 
 
-