org.apache.tools.ant.taskdefs
public class Touch extends Task
If the file to touch doesn't exist, an empty one is created.
Since: Ant 1.1
UNKNOWN: category="filesystem"
Constructor Summary | |
---|---|
Touch()
Construct a new Touch task. |
Method Summary | |
---|---|
void | add(FileNameMapper fileNameMapper)
Add a FileNameMapper . |
void | addConfiguredMapper(Mapper mapper)
Add a Mapper . |
void | addFilelist(FileList list)
Add a filelist to touch. |
void | addFileset(FileSet set)
Add a set of files to touch. |
protected void | checkConfiguration()
Check that this task has been configured properly. |
void | execute()
Execute the touch operation. |
void | setDatetime(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".
|
void | setFile(File file)
Sets a single source file to touch. |
void | setMillis(long millis)
Set the new modification time of file(s) touched
in milliseconds since midnight Jan 1 1970. |
void | setMkdirs(boolean mkdirs)
Set whether nonexistent parent directories should be created
when touching new files. |
void | setPattern(String pattern)
Set the format of the datetime attribute. |
void | setVerbose(boolean verbose)
Set whether the touch task will report every file it creates;
defaults to true . |
protected void | touch()
Does the actual work; assumes everything has been checked by now. |
protected void | touch(File file)
Touch a single file with the current timestamp (this.millis). |
Touch
task.FileNameMapper
.Parameters: fileNameMapper the FileNameMapper
to add.
Throws: BuildException if multiple mappers are added.
Since: Ant 1.6.3
Mapper
.Parameters: mapper the Mapper
to add.
Since: Ant 1.6.3
Parameters: list the Filelist
to add.
Parameters: set the Fileset
to add.
Throws: BuildException if configuration errors are detected.
Since: Ant 1.6.3
Throws: BuildException if an error occurs.
Parameters: dateTime the String
date in the specified format.
Parameters: file the File
to touch.
Parameters: millis the long
timestamp to use.
Parameters: mkdirs boolean
whether to create parent directories.
Since: Ant 1.6.3
Parameters: pattern the SimpleDateFormat
-compatible format pattern.
Since: Ant 1.6.3
true
.Parameters: verbose boolean
flag.
Since: Ant 1.6.3
Throws: BuildException if an error occurs.
Deprecated:
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