Class FileFilterUtils
- Since:
- 1.0
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic IOFileFilter
ageFileFilter
(long cutoffMillis) Returns a filter that returns true if the file was last modified before or at the specified cutoff time.static IOFileFilter
ageFileFilter
(long cutoffMillis, boolean acceptOlder) Returns a filter that filters files based on a cutoff time.static IOFileFilter
ageFileFilter
(File cutoffReference) Returns a filter that returns true if the file was last modified before or at the same time as the specified reference file.static IOFileFilter
ageFileFilter
(File cutoffReference, boolean acceptOlder) Returns a filter that filters files based on a cutoff reference file.static IOFileFilter
ageFileFilter
(Date cutoffDate) Returns a filter that returns true if the file was last modified before or at the specified cutoff date.static IOFileFilter
ageFileFilter
(Date cutoffDate, boolean acceptOlder) Returns a filter that filters files based on a cutoff date.static IOFileFilter
and
(IOFileFilter... filters) Returns a filter that ANDs the specified filters.static IOFileFilter
andFileFilter
(IOFileFilter filter1, IOFileFilter filter2) Deprecated.static IOFileFilter
asFileFilter
(FileFilter filter) Returns anIOFileFilter
that wraps theFileFilter
instance.static IOFileFilter
asFileFilter
(FilenameFilter filter) Returns anIOFileFilter
that wraps theFilenameFilter
instance.static IOFileFilter
Returns a filter that checks if the file is a directory.static IOFileFilter
Returns a filter that always returns false.static IOFileFilter
Returns a filter that checks if the file is a file (and not a directory).static File[]
filter
(IOFileFilter filter, File... files) Applies anIOFileFilter
to the providedFile
objects.static File[]
filter
(IOFileFilter filter, Iterable<File> files) Applies anIOFileFilter
to the providedFile
objects.filterList
(IOFileFilter filter, File... files) Applies anIOFileFilter
to the providedFile
objects.filterList
(IOFileFilter filter, Iterable<File> files) Applies anIOFileFilter
to the providedFile
objects.filterSet
(IOFileFilter filter, File... files) Applies anIOFileFilter
to the providedFile
objects.filterSet
(IOFileFilter filter, Iterable<File> files) Applies anIOFileFilter
to the providedFile
objects.static IOFileFilter
magicNumberFileFilter
(byte[] magicNumber) Returns a filter that accepts files that begin with the provided magic number.static IOFileFilter
magicNumberFileFilter
(byte[] magicNumber, long offset) Returns a filter that accepts files that contains the provided magic number at a specified offset within the file.static IOFileFilter
magicNumberFileFilter
(String magicNumber) Returns a filter that accepts files that begin with the provided magic number.static IOFileFilter
magicNumberFileFilter
(String magicNumber, long offset) Returns a filter that accepts files that contains the provided magic number at a specified offset within the file.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
(String name) Returns a filter that returns true if the file name matches the specified text.static IOFileFilter
nameFileFilter
(String name, IOCase ioCase) Returns a filter that returns true if the file name 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.static IOFileFilter
prefixFileFilter
(String prefix) Returns a filter that returns true if the file name starts with the specified text.static IOFileFilter
prefixFileFilter
(String prefix, IOCase ioCase) Returns a filter that returns true if the file name 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
(String suffix) Returns a filter that returns true if the file name ends with the specified text.static IOFileFilter
suffixFileFilter
(String suffix, IOCase ioCase) Returns a filter that returns true if the file name ends with the specified text.static List
<IOFileFilter> toList
(IOFileFilter... filters) Create a List of file filters.static IOFileFilter
Returns a filter that always returns true.
-
Constructor Details
-
FileFilterUtils
public FileFilterUtils()FileFilterUtils is not normally instantiated.
-
-
Method Details
-
ageFileFilter
Returns a filter that returns true if the file was last modified before or at the specified cutoff date.- Parameters:
cutoffDate
- the time threshold- Returns:
- an appropriately configured age file filter
- Since:
- 1.2
- See Also:
-
ageFileFilter
Returns a filter that filters files based on a cutoff date.- Parameters:
cutoffDate
- the time thresholdacceptOlder
- if true, older files get accepted, if false, newer- Returns:
- an appropriately configured age file filter
- Since:
- 1.2
- See Also:
-
ageFileFilter
Returns a filter that returns true if the file was last modified before or at the same time as the specified reference file.- Parameters:
cutoffReference
- the file whose last modification time is used as the threshold age of the files- Returns:
- an appropriately configured age file filter
- Since:
- 1.2
- See Also:
-
ageFileFilter
Returns a filter that filters files based on a cutoff reference file.- Parameters:
cutoffReference
- the file whose last modification time is used as the threshold age of the filesacceptOlder
- if true, older files get accepted, if false, newer- Returns:
- an appropriately configured age file filter
- Since:
- 1.2
- See Also:
-
ageFileFilter
Returns a filter that returns true if the file was last modified before or at the specified cutoff time.- Parameters:
cutoffMillis
- the time threshold- Returns:
- an appropriately configured age file filter
- Since:
- 1.2
- See Also:
-
ageFileFilter
Returns a filter that filters files based on a cutoff time.- Parameters:
cutoffMillis
- the time thresholdacceptOlder
- if true, older files get accepted, if false, newer- Returns:
- an appropriately configured age file filter
- Since:
- 1.2
- See Also:
-
and
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:
IllegalArgumentException
- if the filters are null or contain a null value.- Since:
- 2.0
- See Also:
-
andFileFilter
Deprecated.Returns a filter that ANDs the two specified filters.- Parameters:
filter1
- the first filterfilter2
- the second filter- Returns:
- a filter that ANDs the two specified filters
- See Also:
-
asFileFilter
Returns anIOFileFilter
that wraps theFileFilter
instance.- Parameters:
filter
- the filter to be wrapped- Returns:
- a new filter that implements IOFileFilter
- See Also:
-
asFileFilter
Returns anIOFileFilter
that wraps theFilenameFilter
instance.- Parameters:
filter
- the filter to be wrapped- Returns:
- a new filter that implements IOFileFilter
- See Also:
-
directoryFileFilter
Returns a filter that checks if the file is a directory.- Returns:
- file filter that accepts only directories and not files
- See Also:
-
falseFileFilter
Returns a filter that always returns false.- Returns:
- a false filter
- See Also:
-
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:
-
filter
Applies an
IOFileFilter
to the providedFile
objects. The resulting array is a subset of the original file list that matches the provided filter.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:
NullPointerException
- if the filter isnull
orfiles
contains anull
value.- Since:
- 2.0
-
filter
Applies an
IOFileFilter
to the providedFile
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:
IllegalArgumentException
- if the filter isnull
orfiles
contains anull
value.- Since:
- 2.0
-
filterList
Applies an
IOFileFilter
to the providedFile
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:
IllegalArgumentException
- if the filter isnull
orfiles
contains anull
value.- Since:
- 2.0
-
filterList
Applies an
IOFileFilter
to the providedFile
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:
IllegalArgumentException
- if the filter isnull
- Since:
- 2.0
-
filterSet
Applies an
IOFileFilter
to the providedFile
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:
IllegalArgumentException
- if the filter isnull
orfiles
contains anull
value.- Since:
- 2.0
-
filterSet
Applies an
IOFileFilter
to the providedFile
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:
IllegalArgumentException
- if the filter isnull
- Since:
- 2.0
-
magicNumberFileFilter
Returns a filter that accepts files that begin with the provided magic number.- Parameters:
magicNumber
- the magic number (byte sequence) to match at the beginning of each file.- Returns:
- an IOFileFilter that accepts files beginning with the provided magic number.
- Throws:
IllegalArgumentException
- ifmagicNumber
isnull
or is of length zero.- Since:
- 2.0
- See Also:
-
magicNumberFileFilter
Returns a filter that accepts files that contains the provided magic number at a specified offset within the file.- Parameters:
magicNumber
- the magic number (byte sequence) to match at the provided offset in each file.offset
- the offset within the files to look for the magic number.- Returns:
- an IOFileFilter that accepts files containing the magic number at the specified offset.
- Throws:
IllegalArgumentException
- ifmagicNumber
isnull
, or contains no bytes, oroffset
is a negative number.- Since:
- 2.0
- See Also:
-
magicNumberFileFilter
Returns a filter that accepts files that begin with the provided magic number.- Parameters:
magicNumber
- the magic number (byte sequence) to match at the beginning of each file.- Returns:
- an IOFileFilter that accepts files beginning with the provided magic number.
- Throws:
IllegalArgumentException
- ifmagicNumber
isnull
or the empty String.- Since:
- 2.0
- See Also:
-
magicNumberFileFilter
Returns a filter that accepts files that contains the provided magic number at a specified offset within the file.- Parameters:
magicNumber
- the magic number (byte sequence) to match at the provided offset in each file.offset
- the offset within the files to look for the magic number.- Returns:
- an IOFileFilter that accepts files containing the magic number at the specified offset.
- Throws:
IllegalArgumentException
- ifmagicNumber
isnull
or the empty String, or if offset is a negative number.- Since:
- 2.0
- See Also:
-
makeCVSAware
Decorates a filter to make it ignore CVS directories. Passing innull
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
- Since:
- 1.1 (method existed but had a bug in 1.0)
-
makeDirectoryOnly
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
- Since:
- 1.3
- See Also:
-
makeFileOnly
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
- Since:
- 1.3
- See Also:
-
makeSVNAware
Decorates a filter to make it ignore SVN directories. Passing innull
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
- Since:
- 1.1
-
nameFileFilter
Returns a filter that returns true if the file name matches the specified text.- Parameters:
name
- the file name- Returns:
- a name checking filter
- See Also:
-
nameFileFilter
Returns a filter that returns true if the file name matches the specified text.- Parameters:
name
- the file nameioCase
- how to handle case sensitivity, null means case-sensitive- Returns:
- a name checking filter
- Since:
- 2.0
- See Also:
-
notFileFilter
Returns a filter that NOTs the specified filter.- Parameters:
filter
- the filter to invert- Returns:
- a filter that NOTs the specified filter
- See Also:
-
or
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:
IllegalArgumentException
- if the filters are null or contain a null value.- Since:
- 2.0
- See Also:
-
orFileFilter
Deprecated.Returns a filter that ORs the two specified filters.- Parameters:
filter1
- the first filterfilter2
- the second filter- Returns:
- a filter that ORs the two specified filters
- See Also:
-
prefixFileFilter
Returns a filter that returns true if the file name starts with the specified text.- Parameters:
prefix
- the file name prefix- Returns:
- a prefix checking filter
- See Also:
-
prefixFileFilter
Returns a filter that returns true if the file name starts with the specified text.- Parameters:
prefix
- the file name prefixioCase
- how to handle case sensitivity, null means case-sensitive- Returns:
- a prefix checking filter
- Since:
- 2.0
- See Also:
-
sizeFileFilter
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
- Since:
- 1.2
- See Also:
-
sizeFileFilter
Returns a filter that filters based on file size.- Parameters:
threshold
- the file size thresholdacceptLarger
- if true, larger files get accepted, if false, smaller- Returns:
- an appropriately configured SizeFileFilter
- Since:
- 1.2
- See Also:
-
sizeRangeFileFilter
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
- Since:
- 1.3
- See Also:
-
suffixFileFilter
Returns a filter that returns true if the file name ends with the specified text.- Parameters:
suffix
- the file name suffix- Returns:
- a suffix checking filter
- See Also:
-
suffixFileFilter
Returns a filter that returns true if the file name ends with the specified text.- Parameters:
suffix
- the file name suffixioCase
- how to handle case sensitivity, null means case-sensitive- Returns:
- a suffix checking filter
- Since:
- 2.0
- See Also:
-
toList
Create a List of file filters.- Parameters:
filters
- The file filters- Returns:
- The list of file filters
- Throws:
NullPointerException
- if the filters are null or contain a null value.- Since:
- 2.0
-
trueFileFilter
Returns a filter that always returns true.- Returns:
- a true filter
- See Also:
-
and(IOFileFilter...)