Home | History | Annotate | Download | only in ant 
      1 /*
      2  * Copyright (C) 2011 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 
     17 package com.android.ant;
     18 
     19 import java.io.File;
     20 import java.util.Set;
     21 
     22 public class InputPath {
     23 
     24     private final File mFile;
     25     /**
     26      * A set of extensions. Only files with an extension in this set will
     27      * be considered for a modification check. All deleted/created files will still be
     28      * checked.
     29      */
     30     private final Set<String> mTouchedExtensions;
     31 
     32     public InputPath(File file) {
     33         this(file, null);
     34     }
     35 
     36     public InputPath(File file, Set<String> extensionsToCheck) {
     37         if (file == null) {
     38             throw new RuntimeException("File in InputPath(File) can't be null");
     39         }
     40         mFile = file;
     41         mTouchedExtensions = extensionsToCheck;
     42     }
     43 
     44     public File getFile() {
     45         return mFile;
     46     }
     47 
     48     /**
     49      * Returns whether this input path (likely actually a folder) must check this files for
     50      * modification (all files are checked for add/delete).
     51      *
     52      * This is configured by constructing the {@link InputPath} with additional restriction
     53      * parameters such as specific extensions.
     54      * @param file the file to check
     55      * @return true if the file must be checked for modification.
     56      */
     57     public boolean checksForModification(File file) {
     58         if (ignores(file)) {
     59             return false;
     60         }
     61 
     62         if (mTouchedExtensions != null &&
     63                 mTouchedExtensions.contains(getExtension(file)) == false) {
     64             return false;
     65         }
     66 
     67         return true;
     68     }
     69 
     70     /**
     71      * Returns whether the InputPath ignores a given file or folder. If it is ignored then
     72      * the file (or folder) is not checked for any event (modification/add/delete).
     73      * If it's a folder, then it and its content are completely ignored.
     74      * @param file the file or folder to check
     75      * @return true if the file or folder are ignored.
     76      */
     77     public boolean ignores(File file) {
     78         // always ignore hidden files/folders.
     79         return file.getName().startsWith(".") == false;
     80     }
     81 
     82     /**
     83      *  Gets the extension (if present) on a file by looking at the filename
     84      *  @param file the file to get the extension from
     85      *  @return the extension if present, or the empty string if the filename doesn't have
     86      *          and extension.
     87      */
     88    protected static String getExtension(File file) {
     89        return getExtension(file.getName());
     90    }
     91 
     92    /**
     93     *  Gets the extension (if present) on a file by looking at the filename
     94     *  @param fileName the filename to get the extension from
     95     *  @return the extension if present, or the empty string if the filename doesn't have
     96     *          and extension.
     97     */
     98    protected static String getExtension(String fileName) {
     99        int index = fileName.lastIndexOf('.');
    100        if (index == -1) {
    101            return "";
    102        }
    103        // Don't include the leading '.' in the extension
    104        return fileName.substring(index + 1);
    105    }
    106 
    107 }
    108