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.

Author:
Commons VFS team
See Also:
Selectors

Method Summary
 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 java.lang.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:
java.lang.Exception - if an error occurs.

traverseDescendents

boolean traverseDescendents(FileSelectInfo fileInfo)
                            throws java.lang.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:
java.lang.Exception - if an error occurs.