com.phloc.commons.io.file.iterate

Class FileSystemRecursiveIterator

java.lang.Object

com.phloc.commons.io.file.iterate.FileSystemRecursiveIterator

All Implemented Interfaces:

IIterableIterator<File>, Iterable<File>, Iterator<File>

@NotThreadSafe
public class FileSystemRecursiveIterator
extends Object
implements IIterableIterator<File>

Recursively iterate the content of a file system directory. This is a depth first iteration, because as soon as a directory is encountered, the children of this directory are iterated.
Note: the order of iteration is undefined and depends on the order returned by FileUtils.getDirectoryContent(File).

Author:

Philip Helger

Constructor Summary

Constructors

Constructor and Description
FileSystemRecursiveIterator(File aBaseDir) Constructor for recursively iterating a file system directory.
FileSystemRecursiveIterator(File aBaseDir, AbstractFileFilter aRecursionFilter) Constructor for recursively iterating a file system directory.
FileSystemRecursiveIterator(File aBaseDir, FileFilter aRecursionFilter) Constructor for recursively iterating a file system directory.
FileSystemRecursiveIterator(File aBaseDir, FilenameFilter aRecursionFilter) Constructor for recursively iterating a file system directory.
FileSystemRecursiveIterator(File aBaseDir, IFilter<File> aRecursionFilter) Constructor for recursively iterating a file system directory.
FileSystemRecursiveIterator(String sBaseDir) Constructor for recursively iterating a file system directory.
FileSystemRecursiveIterator(String sBaseDir, AbstractFileFilter aRecursionFilter) Constructor for recursively iterating a file system directory.
FileSystemRecursiveIterator(String sBaseDir, FileFilter aRecursionFilter) Constructor for recursively iterating a file system directory.
FileSystemRecursiveIterator(String sBaseDir, FilenameFilter aRecursionFilter) Constructor for recursively iterating a file system directory.
FileSystemRecursiveIterator(String sBaseDir, IFilter<File> aRecursionFilter) Constructor for recursively iterating a file system directory.

Method Summary

Methods

Modifier and Type	Method and Description
static IIterableIterator<File>	create(File fBaseDir, FileFilter... aFileFilters) Create a new iterator that recursively descends into sub-directories starting from the given base directory.
static IIterableIterator<File>	create(File fBaseDir, FileFilter aFileFilter) Create a new iterator that recursively descends into sub-directories starting from the given base directory.
static IIterableIterator<File>	create(File fBaseDir, FilenameFilter... aFilenameFilters) Create a new iterator that recursively descends into sub-directories starting from the given base directory.
static IIterableIterator<File>	create(File fBaseDir, FilenameFilter aFilenameFilter) Create a new iterator that recursively descends into sub-directories starting from the given base directory.
static IIterableIterator<File>	create(String sBaseDir, FileFilter... aFileFilters) Create a new iterator that recursively descends into sub-directories starting from the given base directory.
static IIterableIterator<File>	create(String sBaseDir, FileFilter aFileFilter) Create a new iterator that recursively descends into sub-directories starting from the given base directory.
static IIterableIterator<File>	create(String sBaseDir, FilenameFilter... aFilenameFilters) Create a new iterator that recursively descends into sub-directories starting from the given base directory.
static IIterableIterator<File>	create(String sBaseDir, FilenameFilter aFilenameFilter) Create a new iterator that recursively descends into sub-directories starting from the given base directory.
int	getLevel()
boolean	hasNext()
Iterator<File>	iterator()
File	next()
protected boolean	recurseIntoDirectory(File aDirectory) Override this method to manually filter the directories, which are recursed into.
void	remove()
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

FileSystemRecursiveIterator

public FileSystemRecursiveIterator(@Nonnull
                           String sBaseDir)

Constructor for recursively iterating a file system directory.

Parameters:

sBaseDir - The base directory to start with. May not be null.

FileSystemRecursiveIterator

public FileSystemRecursiveIterator(@Nonnull
                           File aBaseDir)

Constructor for recursively iterating a file system directory.

Parameters:

aBaseDir - The base directory to start with. May not be null.

FileSystemRecursiveIterator

public FileSystemRecursiveIterator(@Nonnull
                           String sBaseDir,
                           @Nullable
                           FilenameFilter aRecursionFilter)

Constructor for recursively iterating a file system directory.

Parameters:

sBaseDir - The base directory to start with. May not be null.

aRecursionFilter - An optional filter that controls, into which sub-directories this iterator should descend to. May be null.

FileSystemRecursiveIterator

public FileSystemRecursiveIterator(@Nonnull
                           String sBaseDir,
                           @Nullable
                           FileFilter aRecursionFilter)

Constructor for recursively iterating a file system directory.

Parameters:

sBaseDir - The base directory to start with. May not be null.

aRecursionFilter - An optional filter that controls, into which sub-directories this iterator should descend to. May be null.

FileSystemRecursiveIterator

public FileSystemRecursiveIterator(@Nonnull
                           String sBaseDir,
                           @Nullable
                           AbstractFileFilter aRecursionFilter)

Constructor for recursively iterating a file system directory.

Parameters:

sBaseDir - The base directory to start with. May not be null.

aRecursionFilter - An optional filter that controls, into which sub-directories this iterator should descend to. May be null.

FileSystemRecursiveIterator

public FileSystemRecursiveIterator(@Nonnull
                           String sBaseDir,
                           @Nullable
                           IFilter<File> aRecursionFilter)

Constructor for recursively iterating a file system directory.

Parameters:

sBaseDir - The base directory to start with. May not be null.

aRecursionFilter - An optional filter that controls, into which sub-directories this iterator should descend to. May be null.

FileSystemRecursiveIterator

public FileSystemRecursiveIterator(@Nonnull
                           File aBaseDir,
                           @Nullable
                           FilenameFilter aRecursionFilter)

Constructor for recursively iterating a file system directory.

Parameters:

aBaseDir - The base directory to start with. May not be null.

aRecursionFilter - An optional filter that controls, into which sub-directories this iterator should descend to. May be null.

FileSystemRecursiveIterator

public FileSystemRecursiveIterator(@Nonnull
                           File aBaseDir,
                           @Nullable
                           FileFilter aRecursionFilter)

Constructor for recursively iterating a file system directory.

Parameters:

aBaseDir - The base directory to start with. May not be null.

aRecursionFilter - An optional filter that controls, into which sub-directories this iterator should descend to. May be null.

FileSystemRecursiveIterator

public FileSystemRecursiveIterator(@Nonnull
                           File aBaseDir,
                           @Nullable
                           AbstractFileFilter aRecursionFilter)

Constructor for recursively iterating a file system directory.

Parameters:

aBaseDir - The base directory to start with. May not be null.

aRecursionFilter - An optional filter that controls, into which sub-directories this iterator should descend to. May be null.

FileSystemRecursiveIterator

public FileSystemRecursiveIterator(@Nonnull
                           File aBaseDir,
                           @Nullable
                           IFilter<File> aRecursionFilter)

Constructor for recursively iterating a file system directory.

Parameters:

aBaseDir - The base directory to start with. May not be null.

aRecursionFilter - An optional filter that controls, into which sub-directories this iterator should descend to. May be null.

Method Detail

iterator

@Nonnull
public final Iterator<File> iterator()

Specified by:

iterator in interface Iterable<File>

hasNext

public final boolean hasNext()

Specified by:

hasNext in interface Iterator<File>

recurseIntoDirectory

@OverrideOnDemand
protected boolean recurseIntoDirectory(@Nonnull
                                            File aDirectory)

Override this method to manually filter the directories, which are recursed into.

Parameters:

aDirectory - The non-null directory

Returns:

true if all children of this directory should be investigated

next

@Nonnull
public final File next()

Description copied from interface: IIterableIterator

Specified by:

next in interface IIterableIterator<File>

Specified by:

next in interface Iterator<File>

Returns:

The next element. No constraint whether the element can be null or non-null.

getLevel

@Nonnegative
public final int getLevel()

Returns:

The nesting level of the last file retrieved by next(). Always ≥ 0. The starting directory has level 0.

remove

@UnsupportedOperation
public final void remove()

Specified by:

remove in interface Iterator<File>

toString

public String toString()

Overrides:

toString in class Object

create

@Nonnull
public static IIterableIterator<File> create(@Nonnull
                                     String sBaseDir,
                                     @Nonnull
                                     FilenameFilter aFilenameFilter)

Create a new iterator that recursively descends into sub-directories starting from the given base directory. Additionally a FilenameFilter can be added, that determines, which results to be returned and which not. The difference between the filter passed here and the filter that can be specified in the constructor is the following: the IFilter in the constructor defines into which sub-directories to descend. The FilenameFilter passed to this method only defines which elements should be returned and which not, independent of the iterated files (like a "view").

Parameters:

sBaseDir - The base directory to start iterating. May not be null.

aFilenameFilter - The file filter to be used. May not be null.

Returns:

Never null.

create

@Nonnull
public static IIterableIterator<File> create(@Nonnull
                                     File fBaseDir,
                                     @Nonnull
                                     FilenameFilter aFilenameFilter)

Create a new iterator that recursively descends into sub-directories starting from the given base directory. Additionally a FilenameFilter can be added, that determines, which results to be returned and which not. The difference between the filter passed here and the filter that can be specified in the constructor is the following: the IFilter in the constructor defines into which sub-directories to descend. The FilenameFilter passed to this method only defines which elements should be returned and which not, independent of the iterated files (like a "view").

Parameters:

fBaseDir - The base directory to start iterating. May not be null.

aFilenameFilter - The file filter to be used. May not be null.

Returns:

Never null.

create

@Nonnull
public static IIterableIterator<File> create(@Nonnull
                                     String sBaseDir,
                                     @Nonnull@Nonempty
                                     FilenameFilter... aFilenameFilters)

Create a new iterator that recursively descends into sub-directories starting from the given base directory. Additionally a list of FilenameFilters can be added, that determine, which results to be returned and which not. The difference between the filter passed here and the filter that can be specified in the constructor is the following: the IFilter in the constructor defines into which sub-directories to descend. The FilenameFilters passed to this method only define which elements should be returned and which not, independent of the iterated files (like a "view").

Parameters:

sBaseDir - The base directory to start iterating. May not be null.

aFilenameFilters - The file filter to be used. May neither be null nor empty.

Returns:

Never null.

create

@Nonnull
public static IIterableIterator<File> create(@Nonnull
                                     File fBaseDir,
                                     @Nonnull@Nonempty
                                     FilenameFilter... aFilenameFilters)

Create a new iterator that recursively descends into sub-directories starting from the given base directory. Additionally a list of FilenameFilters can be added, that determine, which results to be returned and which not. The difference between the filter passed here and the filter that can be specified in the constructor is the following: the IFilter in the constructor defines into which sub-directories to descend. The FilenameFilters passed to this method only define which elements should be returned and which not, independent of the iterated files (like a "view").

Parameters:

fBaseDir - The base directory to start iterating. May not be null.

aFilenameFilters - The file filter to be used. May neither be null nor empty.

Returns:

Never null.

create

@Nonnull
public static IIterableIterator<File> create(@Nonnull
                                     String sBaseDir,
                                     @Nonnull
                                     FileFilter aFileFilter)

Create a new iterator that recursively descends into sub-directories starting from the given base directory. Additionally a FileFilter can be added, that determines, which results to be returned and which not. The difference between the filter passed here and the filter that can be specified in the constructor is the following: the IFilter in the constructor defines into which sub-directories to descend. The FileFilter passed to this method only defines which elements should be returned and which not, independent of the iterated files (like a "view").

Parameters:

sBaseDir - The base directory to start iterating. May not be null.

aFileFilter - The file filter to be used. May not be null.

Returns:

Never null.

create

@Nonnull
public static IIterableIterator<File> create(@Nonnull
                                     File fBaseDir,
                                     @Nonnull
                                     FileFilter aFileFilter)

Create a new iterator that recursively descends into sub-directories starting from the given base directory. Additionally a FileFilter can be added, that determines, which results to be returned and which not. The difference between the filter passed here and the filter that can be specified in the constructor is the following: the IFilter in the constructor defines into which sub-directories to descend. The FileFilter passed to this method only defines which elements should be returned and which not, independent of the iterated files (like a "view").

Parameters:

fBaseDir - The base directory to start iterating. May not be null.

aFileFilter - The file filter to be used. May not be null.

Returns:

Never null.

create

@Nonnull
public static IIterableIterator<File> create(@Nonnull
                                     String sBaseDir,
                                     @Nonnull@Nonempty
                                     FileFilter... aFileFilters)

Create a new iterator that recursively descends into sub-directories starting from the given base directory. Additionally a list of FileFilters can be added, that determine, which results to be returned and which not. The difference between the filter passed here and the filter that can be specified in the constructor is the following: the IFilter in the constructor defines into which sub-directories to descend. The FileFilters passed to this method only define which elements should be returned and which not, independent of the iterated files (like a "view").

Parameters:

sBaseDir - The base directory to start iterating. May not be null.

aFileFilters - The file filter to be used. May neither be null nor empty.

Returns:

Never null.

create

@Nonnull
public static IIterableIterator<File> create(@Nonnull
                                     File fBaseDir,
                                     @Nonnull@Nonempty
                                     FileFilter... aFileFilters)

Create a new iterator that recursively descends into sub-directories starting from the given base directory. Additionally a list of FileFilters can be added, that determine, which results to be returned and which not. The difference between the filter passed here and the filter that can be specified in the constructor is the following: the IFilter in the constructor defines into which sub-directories to descend. The FileFilters passed to this method only define which elements should be returned and which not, independent of the iterated files (like a "view").

Parameters:

fBaseDir - The base directory to start iterating. May not be null.

aFileFilters - The file filter to be used. May neither be null nor empty.

Returns:

Never null.