/** * Arara, the cool TeX automation tool * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * 3. Neither the name of the project's author nor the names of its * contributors may be used to endorse or promote products derived from * this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ package com.github.cereda.arara.utils; import java.io.File; import java.util.ArrayList; import java.util.List; import org.apache.commons.io.FileUtils; import org.apache.commons.io.filefilter.FalseFileFilter; import org.apache.commons.io.filefilter.TrueFileFilter; import org.apache.commons.io.filefilter.WildcardFileFilter; /** * Implements file searching utilitary methods. * @author Paulo Roberto Massa Cereda * @version 4.0 * @since 4.0 */ public class FileSearchingUtils { /** * List all files from the provided directory according to the list of * extensions. The leading dot must be omitted, unless it is part of the * extension. * @param directory The provided directory. * @param extensions The list of extensions. * @param recursive A flag indicating whether the search is recursive. * @return A list of files. */ public static List listFilesByExtensions(File directory, List extensions, boolean recursive) { try { // convert the provided extension // list to an extension array String[] array = new String[extensions.size()]; array = extensions.toArray(array); // return the result of the // provided search return new ArrayList( FileUtils.listFiles(directory, array, recursive) ); } catch (Exception nothandled) { // if something bad happens, // gracefully fallback to // an empty file list return new ArrayList(); } } /** * List all files from the provided directory matching the list of file * name patterns. Such list can contain wildcards. * @param directory The provided directory. * @param patterns The list of file name patterns. * @param recursive A flag indicating whether the search is recursive. * @return A list of files. */ public static List listFilesByPatterns(File directory, List patterns, boolean recursive) { try { // return the result of the provided // search, with the wildcard filter // and a potential recursive search return new ArrayList( FileUtils.listFiles( directory, new WildcardFileFilter(patterns), recursive ? TrueFileFilter.INSTANCE : FalseFileFilter.INSTANCE ) ); } catch (Exception nothandled) { // if something bad happens, // gracefully fallback to // an empty file list return new ArrayList(); } } }