org.apache.tools.ant.taskdefs.optional.depend
Class DirectoryIterator
public
class
DirectoryIterator
extends Object
implements ClassFileIterator
An iterator which iterates through the contents of a java directory. The
iterator should be created with the directory at the root of the Java
namespace.
public DirectoryIterator(File rootDirectory, boolean changeInto)
Creates a directory iterator. The directory iterator is created to
scan the root directory. If the changeInto flag is given, then the
entries returned will be relative to this directory and not the
current directory.
Parameters: rootDirectory the root if the directory namespace which is to
be iterated over changeInto if true then the returned entries will be relative
to the rootDirectory and not the current directory.
Throws: IOException if there is a problem reading the directory
information.
Template method to allow subclasses to supply elements for the
iteration. The directory iterator maintains a stack of iterators
covering each level in the directory hierarchy. The current iterator
covers the current directory being scanned. If the next entry in that
directory is a subdirectory, the current iterator is pushed onto the
stack and a new iterator is created for the subdirectory. If the
entry is a file, it is returned as the next element and the iterator
remains valid. If there are no more entries in the current directory,
the topmost iterator on the stack is popped off to become the
current iterator.
Returns: the next ClassFile in the iteration.
Copyright