com.knowgate.io.filefilter

Class NameFileFilter

java.lang.Object

com.knowgate.io.filefilter.AbstractFileFilter

com.knowgate.io.filefilter.NameFileFilter

All Implemented Interfaces:

IOFileFilter, FileFilter, FilenameFilter, Serializable

public class NameFileFilter
extends AbstractFileFilter
implements Serializable

Filters filenames for a certain name.

For example, to print all files and directories in the current directory whose name is Test:

 File dir = new File(".");
 String[] files = dir.list( new NameFileFilter("Test") );
 for ( int i = 0; i < files.length; i++ ) {
     System.out.println(files[i]);
 }
 

Since:

Commons IO 1.0

Version:

$Revision: 606381 $ $Date: 2007-12-22 02:03:16 +0000 (Sat, 22 Dec 2007) $

Author:

Stephen Colebourne, Federico Barbieri, Serge Knystautas, Peter Donald

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
NameFileFilter(List names) Constructs a new case-sensitive name file filter for a list of names.
NameFileFilter(List names, IOCase caseSensitivity) Constructs a new name file filter for a list of names specifying case-sensitivity.
NameFileFilter(String name) Constructs a new case-sensitive name file filter for a single name.
NameFileFilter(String[] names) Constructs a new case-sensitive name file filter for an array of names.
NameFileFilter(String[] names, IOCase caseSensitivity) Constructs a new name file filter for an array of names specifying case-sensitivity.
NameFileFilter(String name, IOCase caseSensitivity) Construct a new name file filter specifying case-sensitivity.

Method Summary

Modifier and Type	Method and Description
boolean	accept(File file) Checks to see if the filename matches.
boolean	accept(File file, String name) Checks to see if the filename matches.
String	toString() Provide a String representaion of this file filter.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

NameFileFilter

public NameFileFilter(String name)

Constructs a new case-sensitive name file filter for a single name.

Parameters:

name - the name to allow, must not be null

Throws:

IllegalArgumentException - if the name is null

NameFileFilter

public NameFileFilter(String name,
                      IOCase caseSensitivity)

Construct a new name file filter specifying case-sensitivity.

Parameters:

name - the name to allow, must not be null

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

Throws:

IllegalArgumentException - if the name is null

NameFileFilter

public NameFileFilter(String[] names)

Constructs a new case-sensitive name file filter for an array of names.

The array is not cloned, so could be changed after constructing the instance. This would be inadvisable however.

Parameters:

names - the names to allow, must not be null

Throws:

IllegalArgumentException - if the names array is null

NameFileFilter

public NameFileFilter(String[] names,
                      IOCase caseSensitivity)

Constructs a new name file filter for an array of names specifying case-sensitivity.

The array is not cloned, so could be changed after constructing the instance. This would be inadvisable however.

Parameters:

names - the names to allow, must not be null

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

Throws:

IllegalArgumentException - if the names array is null

NameFileFilter

public NameFileFilter(List names)

Constructs a new case-sensitive name file filter for a list of names.

Parameters:

names - the names to allow, must not be null

Throws:

IllegalArgumentException - if the name list is null

ClassCastException - if the list does not contain Strings

NameFileFilter

public NameFileFilter(List names,
                      IOCase caseSensitivity)

Constructs a new name file filter for a list of names specifying case-sensitivity.

Parameters:

names - the names to allow, must not be null

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

Throws:

IllegalArgumentException - if the name list is null

ClassCastException - if the list does not contain Strings

Method Detail

accept

public boolean accept(File file)

Checks to see if the filename matches.

Specified by:

accept in interface IOFileFilter

Specified by:

accept in interface FileFilter

Overrides:

accept in class AbstractFileFilter

Parameters:

file - the File to check

Returns:

true if the filename matches

accept

public boolean accept(File file,
                      String name)

Checks to see if the filename matches.

Specified by:

accept in interface IOFileFilter

Specified by:

accept in interface FilenameFilter

Overrides:

accept in class AbstractFileFilter

Parameters:

file - the File directory

name - the filename

Returns:

true if the filename matches

toString

public String toString()

Provide a String representaion of this file filter.

Overrides:

toString in class AbstractFileFilter

Returns:

a String representaion