com.armatiek.infofuze.stream.filesystem.filefilter
Class FileFilterUtils

java.lang.Object
  com.armatiek.infofuze.stream.filesystem.filefilter.FileFilterUtils

public class FileFilterUtils
extends java.lang.Object

Useful utilities for working with file filters. It provides access to all file filter implementations in this package so you don't have to import every class you use. Based on code from Apache Commons IO version 2.01. The main difference is that this class filters objects that implement FileIf, not File. Original authors Stephen Colebourne, Jeremias Maerki, Masato Tezuka, Rahul Akolkar

Constructor Summary

FileFilterUtils()
FileFilterUtils is not normally instantiated.

Method Summary

static IOFileFilter	ageFileFilter(java.util.Date cutoffDate) Returns a filter that returns true if the file was last modified after the specified cutoff date.
static IOFileFilter	ageFileFilter(java.util.Date cutoffDate, boolean acceptOlder) Returns a filter that filters files based on a cutoff date.
static IOFileFilter	ageFileFilter(FileIf cutoffReference) Returns a filter that returns true if the file was last modified after the specified reference file.
static IOFileFilter	ageFileFilter(FileIf cutoffReference, boolean acceptOlder) Returns a filter that filters files based on a cutoff reference file.
static IOFileFilter	ageFileFilter(long cutoff) Returns a filter that returns true if the file was last modified after the specified cutoff time.
static IOFileFilter	ageFileFilter(long cutoff, boolean acceptOlder) Returns a filter that filters files based on a cutoff time.
static IOFileFilter	and(IOFileFilter... filters) Returns a filter that ANDs the specified filters.
static IOFileFilter	andFileFilter(IOFileFilter filter1, IOFileFilter filter2) Deprecated. use and(IOFileFilter...)
static IOFileFilter	directoryFileFilter() Returns a filter that checks if the file is a directory.
static IOFileFilter	falseFileFilter() Returns a filter that always returns false.
static IOFileFilter	fileFileFilter() Returns a filter that checks if the file is a file (and not a directory).
static FileIf[]	filter(IOFileFilter filter, FileIf... files) Applies an IOFileFilter to the provided FileIf objects.
static FileIf[]	filter(IOFileFilter filter, java.lang.Iterable<FileIf> files) Applies an IOFileFilter to the provided File objects.
static java.util.List<FileIf>	filterList(IOFileFilter filter, FileIf... files) Applies an IOFileFilter to the provided File objects.
static java.util.List<FileIf>	filterList(IOFileFilter filter, java.lang.Iterable<FileIf> files) Applies an IOFileFilter to the provided File objects.
static java.util.Set<FileIf>	filterSet(IOFileFilter filter, FileIf... files) Applies an IOFileFilter to the provided File objects.
static java.util.Set<FileIf>	filterSet(IOFileFilter filter, java.lang.Iterable<FileIf> files) Applies an IOFileFilter to the provided File objects.
static IOFileFilter	makeCVSAware(IOFileFilter filter) Decorates a filter to make it ignore CVS directories.
static IOFileFilter	makeDirectoryOnly(IOFileFilter filter) Decorates a filter so that it only applies to directories and not to files.
static IOFileFilter	makeFileOnly(IOFileFilter filter) Decorates a filter so that it only applies to files and not to directories.
static IOFileFilter	makeSVNAware(IOFileFilter filter) Decorates a filter to make it ignore SVN directories.
static IOFileFilter	nameFileFilter(java.lang.String name) Returns a filter that returns true if the filename matches the specified text.
static IOFileFilter	nameFileFilter(java.lang.String name, org.apache.commons.io.IOCase caseSensitivity) Returns a filter that returns true if the filename matches the specified text.
static IOFileFilter	notFileFilter(IOFileFilter filter) Returns a filter that NOTs the specified filter.
static IOFileFilter	or(IOFileFilter... filters) Returns a filter that ORs the specified filters.
static IOFileFilter	orFileFilter(IOFileFilter filter1, IOFileFilter filter2) Deprecated. use or(IOFileFilter...)
static IOFileFilter	prefixFileFilter(java.lang.String prefix) Returns a filter that returns true if the filename starts with the specified text.
static IOFileFilter	prefixFileFilter(java.lang.String prefix, org.apache.commons.io.IOCase caseSensitivity) Returns a filter that returns true if the filename starts with the specified text.
static IOFileFilter	sizeFileFilter(long threshold) Returns a filter that returns true if the file is bigger than a certain size.
static IOFileFilter	sizeFileFilter(long threshold, boolean acceptLarger) Returns a filter that filters based on file size.
static IOFileFilter	sizeRangeFileFilter(long minSizeInclusive, long maxSizeInclusive) Returns a filter that accepts files whose size is >= minimum size and <= maximum size.
static IOFileFilter	suffixFileFilter(java.lang.String suffix) Returns a filter that returns true if the filename ends with the specified text.
static IOFileFilter	suffixFileFilter(java.lang.String suffix, org.apache.commons.io.IOCase caseSensitivity) Returns a filter that returns true if the filename ends with the specified text.
static java.util.List<IOFileFilter>	toList(IOFileFilter... filters) Create a List of file filters.
static IOFileFilter	trueFileFilter() Returns a filter that always returns true.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FileFilterUtils

public FileFilterUtils()

FileFilterUtils is not normally instantiated.

Method Detail

filter

public static FileIf[] filter(IOFileFilter filter,
                              FileIf... files)

Applies an IOFileFilter to the provided FileIf objects. The resulting array is a subset of the original file list that matches the provided filter.

The Set returned by this method is not guaranteed to be thread safe.

 Set<File> allFiles = ...
 Set<File> javaFiles = FileFilterUtils.filterSet(allFiles,
     FileFilterUtils.suffixFileFilter(".java"));
 

Parameters:

filter - the filter to apply to the set of files.

files - the array of files to apply the filter to.

Returns:

a subset of files that is accepted by the file filter.

Throws:

java.lang.IllegalArgumentException - if the filter is null or files contains a null value.

filter

public static FileIf[] filter(IOFileFilter filter,
                              java.lang.Iterable<FileIf> files)

Applies an IOFileFilter to the provided File objects. The resulting array is a subset of the original file list that matches the provided filter.

The Set returned by this method is not guaranteed to be thread safe.

 Set<File> allFiles = ...
 Set<File> javaFiles = FileFilterUtils.filterSet(allFiles,
     FileFilterUtils.suffixFileFilter(".java"));
 

Parameters:

filter - the filter to apply to the set of files.

files - the array of files to apply the filter to.

Returns:

a subset of files that is accepted by the file filter.

Throws:

java.lang.IllegalArgumentException - if the filter is null or files contains a null value.

filterList

public static java.util.List<FileIf> filterList(IOFileFilter filter,
                                                java.lang.Iterable<FileIf> files)

Applies an IOFileFilter to the provided File objects. The resulting list is a subset of the original files that matches the provided filter.

The List returned by this method is not guaranteed to be thread safe.

 List<File> filesAndDirectories = ...
 List<File> directories = FileFilterUtils.filterList(filesAndDirectories,
     FileFilterUtils.directoryFileFilter());
 

Parameters:

filter - the filter to apply to each files in the list.

files - the collection of files to apply the filter to.

Returns:

a subset of files that is accepted by the file filter.

Throws:

java.lang.IllegalArgumentException - if the filter is null or files contains a null value.

filterList

public static java.util.List<FileIf> filterList(IOFileFilter filter,
                                                FileIf... files)

Applies an IOFileFilter to the provided File objects. The resulting list is a subset of the original files that matches the provided filter.

The List returned by this method is not guaranteed to be thread safe.

 List<File> filesAndDirectories = ...
 List<File> directories = FileFilterUtils.filterList(filesAndDirectories,
     FileFilterUtils.directoryFileFilter());
 

Parameters:

filter - the filter to apply to each files in the list.

files - the collection of files to apply the filter to.

Returns:

a subset of files that is accepted by the file filter.

Throws:

java.lang.IllegalArgumentException - if the filter is null or files contains a null value.

filterSet

public static java.util.Set<FileIf> filterSet(IOFileFilter filter,
                                              FileIf... files)

Applies an IOFileFilter to the provided File objects. The resulting set is a subset of the original file list that matches the provided filter.

The Set returned by this method is not guaranteed to be thread safe.

 Set<File> allFiles = ...
 Set<File> javaFiles = FileFilterUtils.filterSet(allFiles,
     FileFilterUtils.suffixFileFilter(".java"));
 

Parameters:

filter - the filter to apply to the set of files.

files - the collection of files to apply the filter to.

Returns:

a subset of files that is accepted by the file filter.

Throws:

java.lang.IllegalArgumentException - if the filter is null or files contains a null value.

filterSet

public static java.util.Set<FileIf> filterSet(IOFileFilter filter,
                                              java.lang.Iterable<FileIf> files)

Applies an IOFileFilter to the provided File objects. The resulting set is a subset of the original file list that matches the provided filter.

The Set returned by this method is not guaranteed to be thread safe.

 Set<File> allFiles = ...
 Set<File> javaFiles = FileFilterUtils.filterSet(allFiles,
     FileFilterUtils.suffixFileFilter(".java"));
 

Parameters:

filter - the filter to apply to the set of files.

files - the collection of files to apply the filter to.

Returns:

a subset of files that is accepted by the file filter.

Throws:

java.lang.IllegalArgumentException - if the filter is null or files contains a null value.

prefixFileFilter

public static IOFileFilter prefixFileFilter(java.lang.String prefix)

Returns a filter that returns true if the filename starts with the specified text.

Parameters:

prefix - the filename prefix

Returns:

a prefix checking filter

See Also:

PrefixFileFilter

prefixFileFilter

public static IOFileFilter prefixFileFilter(java.lang.String prefix,
                                            org.apache.commons.io.IOCase caseSensitivity)

Returns a filter that returns true if the filename starts with the specified text.

Parameters:

prefix - the filename prefix

caseSensitivity - how to handle case sensitivity, null means case-sensitive

Returns:

a prefix checking filter

See Also:

PrefixFileFilter

suffixFileFilter

public static IOFileFilter suffixFileFilter(java.lang.String suffix)

Returns a filter that returns true if the filename ends with the specified text.

Parameters:

suffix - the filename suffix

Returns:

a suffix checking filter

See Also:

SuffixFileFilter

suffixFileFilter

public static IOFileFilter suffixFileFilter(java.lang.String suffix,
                                            org.apache.commons.io.IOCase caseSensitivity)

Returns a filter that returns true if the filename ends with the specified text.

Parameters:

suffix - the filename suffix

caseSensitivity - how to handle case sensitivity, null means case-sensitive

Returns:

a suffix checking filter

See Also:

SuffixFileFilter

nameFileFilter

public static IOFileFilter nameFileFilter(java.lang.String name)

Returns a filter that returns true if the filename matches the specified text.

Parameters:

name - the filename

Returns:

a name checking filter

See Also:

NameFileFilter

nameFileFilter

public static IOFileFilter nameFileFilter(java.lang.String name,
                                          org.apache.commons.io.IOCase caseSensitivity)

Returns a filter that returns true if the filename matches the specified text.

Parameters:

name - the filename

caseSensitivity - how to handle case sensitivity, null means case-sensitive

Returns:

a name checking filter

See Also:

NameFileFilter

directoryFileFilter

public static IOFileFilter directoryFileFilter()

Returns a filter that checks if the file is a directory.

Returns:

file filter that accepts only directories and not files

See Also:

DirectoryFileFilter.DIRECTORY

fileFileFilter

public static IOFileFilter fileFileFilter()

Returns a filter that checks if the file is a file (and not a directory).

Returns:

file filter that accepts only files and not directories

See Also:

FileFileFilter.FILE

andFileFilter

@Deprecated
public static IOFileFilter andFileFilter(IOFileFilter filter1,
                                                    IOFileFilter filter2)

Deprecated. use and(IOFileFilter...)

Returns a filter that ANDs the two specified filters.

Parameters:

filter1 - the first filter

filter2 - the second filter

Returns:

a filter that ANDs the two specified filters

See Also:

and(IOFileFilter...), AndFileFilter

orFileFilter

@Deprecated
public static IOFileFilter orFileFilter(IOFileFilter filter1,
                                                   IOFileFilter filter2)

Deprecated. use or(IOFileFilter...)

Returns a filter that ORs the two specified filters.

Parameters:

filter1 - the first filter

filter2 - the second filter

Returns:

a filter that ORs the two specified filters

See Also:

or(IOFileFilter...), OrFileFilter

and

public static IOFileFilter and(IOFileFilter... filters)

Returns a filter that ANDs the specified filters.

Parameters:

filters - the IOFileFilters that will be ANDed together.

Returns:

a filter that ANDs the specified filters

Throws:

java.lang.IllegalArgumentException - if the filters are null or contain a null value.

See Also:

AndFileFilter

or

public static IOFileFilter or(IOFileFilter... filters)

Returns a filter that ORs the specified filters.

Parameters:

filters - the IOFileFilters that will be ORed together.

Returns:

a filter that ORs the specified filters

Throws:

java.lang.IllegalArgumentException - if the filters are null or contain a null value.

See Also:

OrFileFilter

toList

public static java.util.List<IOFileFilter> toList(IOFileFilter... filters)

Create a List of file filters.

Parameters:

filters - The file filters

Returns:

The list of file filters

Throws:

java.lang.IllegalArgumentException - if the filters are null or contain a null value.

notFileFilter

public static IOFileFilter notFileFilter(IOFileFilter filter)

Returns a filter that NOTs the specified filter.

Parameters:

filter - the filter to invert

Returns:

a filter that NOTs the specified filter

See Also:

NotFileFilter

trueFileFilter

public static IOFileFilter trueFileFilter()

Returns a filter that always returns true.

Returns:

a true filter

See Also:

TrueFileFilter.TRUE

falseFileFilter

public static IOFileFilter falseFileFilter()

Returns a filter that always returns false.

Returns:

a false filter

See Also:

FalseFileFilter.FALSE

ageFileFilter

public static IOFileFilter ageFileFilter(long cutoff)

Returns a filter that returns true if the file was last modified after the specified cutoff time.

Parameters:

cutoff - the time threshold

Returns:

an appropriately configured age file filter

See Also:

AgeFileFilter

ageFileFilter

public static IOFileFilter ageFileFilter(long cutoff,
                                         boolean acceptOlder)

Returns a filter that filters files based on a cutoff time.

Parameters:

cutoff - the time threshold

acceptOlder - if true, older files get accepted, if false, newer

Returns:

an appropriately configured age file filter

See Also:

AgeFileFilter

ageFileFilter

public static IOFileFilter ageFileFilter(java.util.Date cutoffDate)

Returns a filter that returns true if the file was last modified after the specified cutoff date.

Parameters:

cutoffDate - the time threshold

Returns:

an appropriately configured age file filter

See Also:

AgeFileFilter

ageFileFilter

public static IOFileFilter ageFileFilter(java.util.Date cutoffDate,
                                         boolean acceptOlder)

Returns a filter that filters files based on a cutoff date.

Parameters:

cutoffDate - the time threshold

acceptOlder - if true, older files get accepted, if false, newer

Returns:

an appropriately configured age file filter

See Also:

AgeFileFilter

ageFileFilter

public static IOFileFilter ageFileFilter(FileIf cutoffReference)

Returns a filter that returns true if the file was last modified after the specified reference file.

Parameters:

cutoffReference - the file whose last modification time is usesd as the threshold age of the files

Returns:

an appropriately configured age file filter

See Also:

AgeFileFilter

ageFileFilter

public static IOFileFilter ageFileFilter(FileIf cutoffReference,
                                         boolean acceptOlder)

Returns a filter that filters files based on a cutoff reference file.

Parameters:

cutoffReference - the file whose last modification time is usesd as the threshold age of the files

acceptOlder - if true, older files get accepted, if false, newer

Returns:

an appropriately configured age file filter

See Also:

AgeFileFilter

sizeFileFilter

public static IOFileFilter sizeFileFilter(long threshold)

Returns a filter that returns true if the file is bigger than a certain size.

Parameters:

threshold - the file size threshold

Returns:

an appropriately configured SizeFileFilter

See Also:

SizeFileFilter

sizeFileFilter

public static IOFileFilter sizeFileFilter(long threshold,
                                          boolean acceptLarger)

Returns a filter that filters based on file size.

Parameters:

threshold - the file size threshold

acceptLarger - if true, larger files get accepted, if false, smaller

Returns:

an appropriately configured SizeFileFilter

See Also:

SizeFileFilter

sizeRangeFileFilter

public static IOFileFilter sizeRangeFileFilter(long minSizeInclusive,
                                               long maxSizeInclusive)

Returns a filter that accepts files whose size is >= minimum size and <= maximum size.

Parameters:

minSizeInclusive - the minimum file size (inclusive)

maxSizeInclusive - the maximum file size (inclusive)

Returns:

an appropriately configured IOFileFilter

See Also:

SizeFileFilter

makeCVSAware

public static IOFileFilter makeCVSAware(IOFileFilter filter)

Decorates a filter to make it ignore CVS directories. Passing in null will return a filter that accepts everything except CVS directories.

Parameters:

filter - the filter to decorate, null means an unrestricted filter

Returns:

the decorated filter, never null

makeSVNAware

public static IOFileFilter makeSVNAware(IOFileFilter filter)

Decorates a filter to make it ignore SVN directories. Passing in null will return a filter that accepts everything except SVN directories.

Parameters:

filter - the filter to decorate, null means an unrestricted filter

Returns:

the decorated filter, never null

makeDirectoryOnly

public static IOFileFilter makeDirectoryOnly(IOFileFilter filter)

Decorates a filter so that it only applies to directories and not to files.

Parameters:

filter - the filter to decorate, null means an unrestricted filter

Returns:

the decorated filter, never null

See Also:

DirectoryFileFilter.DIRECTORY

makeFileOnly

public static IOFileFilter makeFileOnly(IOFileFilter filter)

Decorates a filter so that it only applies to files and not to directories.

Parameters:

filter - the filter to decorate, null means an unrestricted filter

Returns:

the decorated filter, never null

See Also:

FileFileFilter.FILE