org.apache.commons.vfs2

Interface FileSelector

All Known Implementing Classes:

AllFileSelector, FileDepthSelector, FileFilterSelector, FileTypeSelector

public interface FileSelector

This interface is used to select files when traversing a file hierarchy.

Version:

$Revision: 1035154 $ $Date: 2010-11-15 11:58:06 +0530 (Mon, 15 Nov 2010) $

Author:

Commons VFS team

See Also:

Selectors

Method Summary

Methods

Modifier and Type	Method and Description
boolean	includeFile(FileSelectInfo fileInfo) Determines if a file or folder should be selected.
boolean	traverseDescendents(FileSelectInfo fileInfo) Determines whether a folder should be traversed.

Method Detail

includeFile

boolean includeFile(FileSelectInfo fileInfo)
                    throws Exception

Determines if a file or folder should be selected. This method is called in depthwise order (that is, it is called for the children of a folder before it is called for the folder itself).

Parameters:

fileInfo - the file or folder to select.

Returns:

true if the file should be selected.

Throws:

Exception - if an error occurs.

traverseDescendents

boolean traverseDescendents(FileSelectInfo fileInfo)
                            throws Exception

Determines whether a folder should be traversed. If this method returns true, includeFile(org.apache.commons.vfs2.FileSelectInfo) is called for each of the children of the folder, and each of the child folders is recursively traversed.

This method is called on a folder before includeFile(org.apache.commons.vfs2.FileSelectInfo) is called.

Parameters:

fileInfo - the file or folder to select.

Returns:

true if the folder should be traversed.

Throws:

Exception - if an error occurs.