org.apache.commons.io.filefilter

Class AbstractFileFilter

java.lang.Object

org.apache.commons.io.filefilter.AbstractFileFilter

All Implemented Interfaces:

java.io.FileFilter, java.io.FilenameFilter, java.nio.file.FileVisitor<java.nio.file.Path>, PathFilter, PathVisitor, IOFileFilter

Direct Known Subclasses:

AgeFileFilter, AndFileFilter, CanExecuteFileFilter, CanReadFileFilter, CanWriteFileFilter, DelegateFileFilter, DirectoryFileFilter, EmptyFileFilter, FileEqualsFileFilter, FileFileFilter, HiddenFileFilter, MagicNumberFileFilter, NameFileFilter, NotFileFilter, OrFileFilter, PathEqualsFileFilter, PathVisitorFileFilter, PrefixFileFilter, RegexFileFilter, SizeFileFilter, SuffixFileFilter, SymbolicLinkFileFilter, WildcardFileFilter, WildcardFilter

public abstract class AbstractFileFilter
extends java.lang.Object
implements IOFileFilter, PathVisitor

Abstracts the implementation of the FileFilter (IO), FilenameFilter (IO), PathFilter (NIO) interfaces via our own IOFileFilter interface.

Note that a subclass MUST override one of the accept methods, otherwise that subclass will infinitely loop.

Since:

1.0

Field Summary

Fields inherited from interface org.apache.commons.io.filefilter.IOFileFilter

EMPTY_STRING_ARRAY

Constructor Summary

Constructors

Constructor and Description
AbstractFileFilter()

Method Summary

Modifier and Type	Method and Description
boolean	accept(java.io.File file) Checks to see if the File should be accepted by this filter.
boolean	accept(java.io.File dir, java.lang.String name) Checks to see if the File should be accepted by this filter.
protected java.nio.file.FileVisitResult	handle(java.lang.Throwable t) Handles exceptions caught while accepting.
java.nio.file.FileVisitResult	postVisitDirectory(java.nio.file.Path dir, java.io.IOException exc)
java.nio.file.FileVisitResult	preVisitDirectory(java.nio.file.Path dir, java.nio.file.attribute.BasicFileAttributes attributes)
(package private) static java.nio.file.FileVisitResult	toFileVisitResult(boolean accept, java.nio.file.Path path)
java.lang.String	toString() Provides a String representation of this file filter.
java.nio.file.FileVisitResult	visitFile(java.nio.file.Path file, java.nio.file.attribute.BasicFileAttributes attributes)
java.nio.file.FileVisitResult	visitFileFailed(java.nio.file.Path file, java.io.IOException exc)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.commons.io.filefilter.IOFileFilter

accept, and, negate, or

Constructor Detail

AbstractFileFilter

public AbstractFileFilter()

Method Detail

toFileVisitResult

static java.nio.file.FileVisitResult toFileVisitResult(boolean accept,
                                                       java.nio.file.Path path)

accept

public boolean accept(java.io.File file)

Checks to see if the File should be accepted by this filter.

Specified by:

accept in interface java.io.FileFilter

Specified by:

accept in interface IOFileFilter

Parameters:

file - the File to check

Returns:

true if this file matches the test

accept

public boolean accept(java.io.File dir,
                      java.lang.String name)

Checks to see if the File should be accepted by this filter.

Specified by:

accept in interface java.io.FilenameFilter

Specified by:

accept in interface IOFileFilter

Parameters:

dir - the directory File to check

name - the file name within the directory to check

Returns:

true if this file matches the test

handle

protected java.nio.file.FileVisitResult handle(java.lang.Throwable t)

Handles exceptions caught while accepting.

Parameters:

t - the caught Throwable.

Returns:

the given Throwable.

Since:

2.9.0

postVisitDirectory

public java.nio.file.FileVisitResult postVisitDirectory(java.nio.file.Path dir,
                                                        java.io.IOException exc)
                                                 throws java.io.IOException

Specified by:

postVisitDirectory in interface java.nio.file.FileVisitor<java.nio.file.Path>

Throws:

java.io.IOException

preVisitDirectory

public java.nio.file.FileVisitResult preVisitDirectory(java.nio.file.Path dir,
                                                       java.nio.file.attribute.BasicFileAttributes attributes)
                                                throws java.io.IOException

Specified by:

preVisitDirectory in interface java.nio.file.FileVisitor<java.nio.file.Path>

Throws:

java.io.IOException

toString

public java.lang.String toString()

Provides a String representation of this file filter.

Overrides:

toString in class java.lang.Object

Returns:

a String representation

visitFile

public java.nio.file.FileVisitResult visitFile(java.nio.file.Path file,
                                               java.nio.file.attribute.BasicFileAttributes attributes)
                                        throws java.io.IOException

Specified by:

visitFile in interface java.nio.file.FileVisitor<java.nio.file.Path>

Throws:

java.io.IOException

visitFileFailed

public java.nio.file.FileVisitResult visitFileFailed(java.nio.file.Path file,
                                                     java.io.IOException exc)
                                              throws java.io.IOException

Specified by:

visitFileFailed in interface java.nio.file.FileVisitor<java.nio.file.Path>

Throws:

java.io.IOException