diff options
Diffstat (limited to 'framework/src/ant/apache-ant-1.9.6/src/main/org/apache/tools/ant/util/SourceFileScanner.java')
-rw-r--r-- | framework/src/ant/apache-ant-1.9.6/src/main/org/apache/tools/ant/util/SourceFileScanner.java | 173 |
1 files changed, 173 insertions, 0 deletions
diff --git a/framework/src/ant/apache-ant-1.9.6/src/main/org/apache/tools/ant/util/SourceFileScanner.java b/framework/src/ant/apache-ant-1.9.6/src/main/org/apache/tools/ant/util/SourceFileScanner.java new file mode 100644 index 00000000..c79f0347 --- /dev/null +++ b/framework/src/ant/apache-ant-1.9.6/src/main/org/apache/tools/ant/util/SourceFileScanner.java @@ -0,0 +1,173 @@ +/* + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed with + * this work for additional information regarding copyright ownership. + * The ASF licenses this file to You under the Apache License, Version 2.0 + * (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + */ + +package org.apache.tools.ant.util; + +import java.io.File; +import java.util.Vector; + +import org.apache.tools.ant.Task; +import org.apache.tools.ant.types.Resource; +import org.apache.tools.ant.types.ResourceFactory; +import org.apache.tools.ant.types.resources.FileResource; + +/** + * Utility class that collects the functionality of the various + * scanDir methods that have been scattered in several tasks before. + * + * <p>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.</p> + * + */ +public class SourceFileScanner implements ResourceFactory { + + // CheckStyle:VisibilityModifier OFF - bc + protected Task task; + // CheckStyle:VisibilityModifier ON + + private static final FileUtils FILE_UTILS = FileUtils.getFileUtils(); + private File destDir; // base directory of the fileset + + /** + * Construct a new SourceFileScanner. + * @param task The task we should log messages through. + */ + public SourceFileScanner(Task task) { + this.task = task; + } + + /** + * Restrict the given set of files to those that are newer than + * their corresponding target files. + * + * @param files the original set of files. + * @param srcDir all files are relative to this directory. + * @param destDir target files live here. if null file names + * returned by the mapper are assumed to be absolute. + * @param mapper knows how to construct a target file names from + * source file names. + * @return an array of filenames. + */ + public String[] restrict(String[] files, File srcDir, File destDir, + FileNameMapper mapper) { + return restrict(files, srcDir, destDir, mapper, + FILE_UTILS.getFileTimestampGranularity()); + } + + /** + * Restrict the given set of files to those that are newer than + * their corresponding target files. + * + * @param files the original set of files. + * @param srcDir all files are relative to this directory. + * @param destDir target files live here. If null file names + * returned by the mapper are assumed to be absolute. + * @param mapper knows how to construct a target file names from + * source file names. + * @param granularity The number of milliseconds leeway to give + * before deciding a target is out of date. + * @return an array of filenames. + * + * @since Ant 1.6.2 + */ + public String[] restrict(String[] files, File srcDir, File destDir, + FileNameMapper mapper, long granularity) { + // record destdir for later use in getResource + this.destDir = destDir; + Vector v = new Vector(); + for (int i = 0; i < files.length; i++) { + final String name = files[i]; + v.addElement(new FileResource(srcDir, name) { + public String getName() { + return name; + } + }); + } + Resource[] sourceresources = new Resource[v.size()]; + v.copyInto(sourceresources); + + // build the list of sources which are out of date with + // respect to the target + Resource[] outofdate = + ResourceUtils.selectOutOfDateSources(task, sourceresources, + mapper, this, granularity); + String[] result = new String[outofdate.length]; + for (int counter = 0; counter < outofdate.length; counter++) { + result[counter] = outofdate[counter].getName(); + } + return result; + } + + /** + * Convenience layer on top of restrict that returns the source + * files as File objects (containing absolute paths if srcDir is + * absolute). + * @param files the original set of files. + * @param srcDir all files are relative to this directory. + * @param destDir target files live here. If null file names + * returned by the mapper are assumed to be absolute. + * @param mapper knows how to construct a target file names from + * source file names. + * @return an array of files. + */ + public File[] restrictAsFiles(String[] files, File srcDir, File destDir, + FileNameMapper mapper) { + return restrictAsFiles(files, srcDir, destDir, mapper, + FILE_UTILS.getFileTimestampGranularity()); + } + + /** + * Convenience layer on top of restrict that returns the source + * files as File objects (containing absolute paths if srcDir is + * absolute). + * + * @param files the original set of files. + * @param srcDir all files are relative to this directory. + * @param destDir target files live here. If null file names + * returned by the mapper are assumed to be absolute. + * @param mapper knows how to construct a target file names from + * source file names. + * @param granularity The number of milliseconds leeway to give + * before deciding a target is out of date. + * @return an array of files. + * @since Ant 1.6.2 + */ + public File[] restrictAsFiles(String[] files, File srcDir, File destDir, + FileNameMapper mapper, long granularity) { + String[] res = restrict(files, srcDir, destDir, mapper, granularity); + File[] result = new File[res.length]; + for (int i = 0; i < res.length; i++) { + result[i] = new File(srcDir, res[i]); + } + return result; + } + + /** + * Returns resource information for a file at destination. + * @param name relative path of file at destination. + * @return data concerning a file whose relative path to destDir is name. + * + * @since Ant 1.5.2 + */ + public Resource getResource(String name) { + return new FileResource(destDir, name); + } + +} + |