org.apache.tools.ant.util
Class SourceFileScanner
java.lang.Object
org.apache.tools.ant.util.SourceFileScanner
- ResourceFactory
public class SourceFileScanner
extends java.lang.Object
Utility class that collects the functionality of the various
scanDir methods that have been scattered in several tasks before.
The only method returns an array of source files. The array is a
subset of the files given as a parameter and holds only those that
are newer than their corresponding target files.
Resource | getResource(String name) - Returns resource information for a file at destination.
|
String[] | restrict(String[] files, File srcDir, File destDir, FileNameMapper mapper) - Restrict the given set of files to those that are newer than
their corresponding target files.
|
String[] | restrict(String[] files, File srcDir, File destDir, FileNameMapper mapper, long granularity) - Restrict the given set of files to those that are newer than
their corresponding target files.
|
File[] | restrictAsFiles(String[] files, File srcDir, File destDir, FileNameMapper mapper) - Convenience layer on top of restrict that returns the source
files as File objects (containing absolute paths if srcDir is
absolute).
|
File[] | restrictAsFiles(String[] files, File srcDir, File destDir, FileNameMapper mapper, long granularity) - Convenience layer on top of restrict that returns the source
files as File objects (containing absolute paths if srcDir is
absolute).
|
SourceFileScanner
public SourceFileScanner(Task task)
Construct a new SourceFileScanner.
task
- The task we should log messages through.
getResource
public Resource getResource(String name)
Returns resource information for a file at destination.
- getResource in interface ResourceFactory
name
- relative path of file at destination.
- data concerning a file whose relative path to destDir is name.
restrict
public String[] restrict(String[] files,
File srcDir,
File destDir,
FileNameMapper mapper)
Restrict the given set of files to those that are newer than
their corresponding target files.
files
- the original set of files.srcDir
- all files are relative to this directory.destDir
- target files live here. if null file names
returned by the mapper are assumed to be absolute.mapper
- knows how to construct a target file names from
source file names.
restrict
public String[] restrict(String[] files,
File srcDir,
File destDir,
FileNameMapper mapper,
long granularity)
Restrict the given set of files to those that are newer than
their corresponding target files.
files
- the original set of files.srcDir
- all files are relative to this directory.destDir
- target files live here. If null file names
returned by the mapper are assumed to be absolute.mapper
- knows how to construct a target file names from
source file names.granularity
- The number of milliseconds leeway to give
before deciding a target is out of date.
restrictAsFiles
public File[] restrictAsFiles(String[] files,
File srcDir,
File destDir,
FileNameMapper mapper)
Convenience layer on top of restrict that returns the source
files as File objects (containing absolute paths if srcDir is
absolute).
files
- the original set of files.srcDir
- all files are relative to this directory.destDir
- target files live here. If null file names
returned by the mapper are assumed to be absolute.mapper
- knows how to construct a target file names from
source file names.
restrictAsFiles
public File[] restrictAsFiles(String[] files,
File srcDir,
File destDir,
FileNameMapper mapper,
long granularity)
Convenience layer on top of restrict that returns the source
files as File objects (containing absolute paths if srcDir is
absolute).
files
- the original set of files.srcDir
- all files are relative to this directory.destDir
- target files live here. If null file names
returned by the mapper are assumed to be absolute.mapper
- knows how to construct a target file names from
source file names.granularity
- The number of milliseconds leeway to give
before deciding a target is out of date.