org.apache.commons.vfs2

Interface FileSelector

All Known Implementing Classes:

AllFileSelector, FileDepthSelector, FileExtensionSelector, FileFilterSelector, FileTypeSelector, InvertIncludeFileSelector, PatternFileSelector

public interface FileSelector

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

See Also:

Selectors

Method Summary

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.