public class WildcardFileFilter extends AbstractFileFilter implements java.io.Serializable
This filter selects files and directories based on one or more wildcards. Testing is case-sensitive by default, but this can be configured.
The wildcard matcher uses the characters '?' and '*' to represent a
single or multiple wildcard characters.
This is the same as often found on Dos/Unix command lines.
The check is case-sensitive by default.
See FilenameUtils.wildcardMatchOnSystem(String,String)
for more information.
For example:
File dir = new File("."); FileFilter fileFilter = new WildcardFileFilter("*test*.java~*~"); File[] files = dir.listFiles(fileFilter); for (String file : files) { System.out.println(file); }
final Path dir = Paths.get(""); final AccumulatorPathVisitor visitor = AccumulatorPathVisitor.withLongCounters(new WildcardFileFilter("*test*.java~*~")); // // Walk one dir Files.walkFileTree(dir, Collections.emptySet(), 1, visitor); System.out.println(visitor.getPathCounters()); System.out.println(visitor.getFileList()); // visitor.getPathCounters().reset(); // // Walk dir tree Files.walkFileTree(dir, visitor); System.out.println(visitor.getPathCounters()); System.out.println(visitor.getDirList()); System.out.println(visitor.getFileList());
Modifier and Type | Field and Description |
---|---|
private IOCase |
caseSensitivity
Whether the comparison is case sensitive.
|
private static long |
serialVersionUID |
private java.lang.String[] |
wildcards
The wildcards that will be used to match file names.
|
EMPTY_STRING_ARRAY
Constructor and Description |
---|
WildcardFileFilter(java.util.List<java.lang.String> wildcards)
Construct a new case-sensitive wildcard filter for a list of wildcards.
|
WildcardFileFilter(java.util.List<java.lang.String> wildcards,
IOCase caseSensitivity)
Construct a new wildcard filter for a list of wildcards specifying case-sensitivity.
|
WildcardFileFilter(java.lang.String... wildcards)
Construct a new case-sensitive wildcard filter for an array of wildcards.
|
WildcardFileFilter(java.lang.String wildcard)
Construct a new case-sensitive wildcard filter for a single wildcard.
|
WildcardFileFilter(java.lang.String[] wildcards,
IOCase caseSensitivity)
Construct a new wildcard filter for an array of wildcards specifying case-sensitivity.
|
WildcardFileFilter(java.lang.String wildcard,
IOCase caseSensitivity)
Construct a new wildcard filter for a single wildcard specifying case-sensitivity.
|
Modifier and Type | Method and Description |
---|---|
boolean |
accept(java.io.File file)
Checks to see if the file name matches one of the wildcards.
|
boolean |
accept(java.io.File dir,
java.lang.String name)
Checks to see if the file name matches one of the wildcards.
|
java.nio.file.FileVisitResult |
accept(java.nio.file.Path file,
java.nio.file.attribute.BasicFileAttributes attributes)
Checks to see if the file name matches one of the wildcards.
|
private boolean |
accept(java.lang.String name) |
java.lang.String |
toString()
Provide a String representation of this file filter.
|
handle, postVisitDirectory, preVisitDirectory, toFileVisitResult, visitFile, visitFileFailed
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
and, negate, or
private static final long serialVersionUID
private final java.lang.String[] wildcards
private final IOCase caseSensitivity
public WildcardFileFilter(java.util.List<java.lang.String> wildcards)
wildcards
- the list of wildcards to match, not nulljava.lang.IllegalArgumentException
- if the pattern list is nulljava.lang.ClassCastException
- if the list does not contain Stringspublic WildcardFileFilter(java.util.List<java.lang.String> wildcards, IOCase caseSensitivity)
wildcards
- the list of wildcards to match, not nullcaseSensitivity
- how to handle case sensitivity, null means case-sensitivejava.lang.IllegalArgumentException
- if the pattern list is nulljava.lang.ClassCastException
- if the list does not contain Stringspublic WildcardFileFilter(java.lang.String wildcard)
wildcard
- the wildcard to matchjava.lang.IllegalArgumentException
- if the pattern is nullpublic WildcardFileFilter(java.lang.String... wildcards)
wildcards
- the array of wildcards to matchjava.lang.IllegalArgumentException
- if the pattern array is nullpublic WildcardFileFilter(java.lang.String wildcard, IOCase caseSensitivity)
wildcard
- the wildcard to match, not nullcaseSensitivity
- how to handle case sensitivity, null means case-sensitivejava.lang.IllegalArgumentException
- if the pattern is nullpublic WildcardFileFilter(java.lang.String[] wildcards, IOCase caseSensitivity)
wildcards
- the array of wildcards to match, not nullcaseSensitivity
- how to handle case sensitivity, null means case-sensitivejava.lang.IllegalArgumentException
- if the pattern array is nullpublic boolean accept(java.io.File file)
accept
in interface java.io.FileFilter
accept
in interface IOFileFilter
accept
in class AbstractFileFilter
file
- the file to checkpublic boolean accept(java.io.File dir, java.lang.String name)
accept
in interface java.io.FilenameFilter
accept
in interface IOFileFilter
accept
in class AbstractFileFilter
dir
- the file directory (ignored)name
- the file namepublic java.nio.file.FileVisitResult accept(java.nio.file.Path file, java.nio.file.attribute.BasicFileAttributes attributes)
accept
in interface PathFilter
accept
in interface IOFileFilter
file
- the file to checkattributes
- the file's basic attributes (TODO may be null).private boolean accept(java.lang.String name)
public java.lang.String toString()
toString
in class AbstractFileFilter