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

public class Touch

extends Task

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.

Note: Setting the modification time of files is not supported in JDK 1.1.

Since:

Ant 1.1

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

Touch()

Method Summary

void	addFilelist(FileList list) Add a filelist to touch
void	addFileset(FileSet set) Add a set of files to touch
void	execute() Execute the touch operation.
void	setDatetime(java.lang.String dateTime) the new modification time of the file in the format "MM/DD/YYYY HH:MM AM or PM" or "MM/DD/YYYY HH:MM:SS AM or PM".
void	setFile(java.io.File file) Sets a single source file to touch.
void	setMillis(long millis) the new modification time of the file in milliseconds since midnight Jan 1 1970.
protected void	touch() Does the actual work; assumes everything has been checked by now.
protected void	touch(java.io.File file) touch a single file with the current timestamp (this.millis)

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

Touch

public Touch()

Method Detail

setFile

public void setFile(java.io.File file)

Sets a single source file to touch. If the file does not exist an empty file will be created.

setMillis

public void setMillis(long millis)

the new modification time of the file in milliseconds since midnight Jan 1 1970. Optional, default=now

setDatetime

public void setDatetime(java.lang.String dateTime)

the new modification time of the file in the format "MM/DD/YYYY HH:MM AM or PM" or "MM/DD/YYYY HH:MM:SS AM or PM". Optional, default=now

addFileset

public void addFileset(FileSet set)

Add a set of files to touch

addFilelist

public void addFilelist(FileList list)

Add a filelist to touch

execute

public void execute()
             throws BuildException

Execute the touch operation.

Overrides:

execute in class Task

Throws:

BuildException - if something goes wrong with the build

touch

protected void touch()
              throws BuildException

Does the actual work; assumes everything has been checked by now.

BuildException

touch

protected void touch(java.io.File file)
              throws BuildException

touch a single file with the current timestamp (this.millis)

Parameters:

file - file to touch

Throws:

BuildException