org.apache.tools.ant.taskdefs
public class Sync extends Task
Uses a <copy> task internally, but forbidding the use of mappers and filter chains. Files of the destination directory not present in any of the source fileset are removed.
Since: Ant 1.6 revised by Dan Armbrust to remove orphaned directories.
UNKNOWN: category="filesystem"
Nested Class Summary | |
---|---|
static class | Sync.MyCopy
Subclass Copy in order to access it's file/dir maps. |
static class | Sync.SyncTarget
Inner class used to hold exclude patterns and selectors to save
stuff that happens to live in the target directory but should
not get removed.
|
Method Summary | |
---|---|
void | add(ResourceCollection rc)
Adds a collection of filesystem resources to copy. |
void | addFileset(FileSet set)
Adds a set of files to copy. |
void | addPreserveInTarget(Sync.SyncTarget s)
A container for patterns and selectors that can be used to
specify files that should be kept in the target even if they
are not present in any source directory.
|
void | execute()
Execute the sync task. |
void | init()
Initialize the sync task. |
void | setFailOnError(boolean failonerror)
If false, note errors to the output but keep going. |
void | setGranularity(long granularity)
The number of milliseconds leeway to give before deciding a
target is out of date.
|
void | setIncludeEmptyDirs(boolean includeEmpty)
Used to copy empty directories. |
void | setOverwrite(boolean overwrite)
Overwrite any existing destination file(s). |
void | setTodir(File destDir)
Sets the destination directory. |
void | setVerbose(boolean verbose)
Used to force listing of all names of copied files. |
Parameters: rc a resource collection
Since: Ant 1.7
Parameters: set a fileset
You must not invoke this method more than once.
Parameters: s a preserveintarget nested element
Since: Ant 1.7
Throws: BuildException if there is an error.
See Also: execute
Throws: BuildException if there is a problem.
See Also: init
Parameters: failonerror true or false
Default is 0 milliseconds, or 2 seconds on DOS systems.
Parameters: granularity a long
value
Since: Ant 1.6.2
Parameters: includeEmpty If true copy empty directories.
Parameters: overwrite if true overwrite any existing destination file(s).
Parameters: destDir the destination directory
Parameters: verbose if true force listing of all names of copied files.