Class SimpleFileVisitor<T>
java.lang.Object
java.nio.file.SimpleFileVisitor<T>
- Type Parameters:
T
- The type of reference to the files
- All Implemented Interfaces:
FileVisitor<T>
A simple visitor of files with default behavior to visit all files and to
re-throw I/O errors.
Methods in this class may be overridden subject to their general contract.
- Since:
- 1.7
-
Constructor Summary
ModifierConstructorDescriptionprotected
Initializes a new instance of this class. -
Method Summary
Modifier and TypeMethodDescriptionpostVisitDirectory
(T dir, IOException exc) Invoked for a directory after entries in the directory, and all of their descendants, have been visited.preVisitDirectory
(T dir, BasicFileAttributes attrs) Invoked for a directory before entries in the directory are visited.visitFile
(T file, BasicFileAttributes attrs) Invoked for a file in a directory.visitFileFailed
(T file, IOException exc) Invoked for a file that could not be visited.
-
Constructor Details
-
SimpleFileVisitor
protected SimpleFileVisitor()Initializes a new instance of this class.
-
-
Method Details
-
preVisitDirectory
Invoked for a directory before entries in the directory are visited.Unless overridden, this method returns
CONTINUE
.- Specified by:
preVisitDirectory
in interfaceFileVisitor<T>
- Parameters:
dir
- a reference to the directoryattrs
- the directory's basic attributes- Returns:
- the visit result
- Throws:
IOException
- if an I/O error occurs
-
visitFile
Invoked for a file in a directory.Unless overridden, this method returns
CONTINUE
.- Specified by:
visitFile
in interfaceFileVisitor<T>
- Parameters:
file
- a reference to the fileattrs
- the file's basic attributes- Returns:
- the visit result
- Throws:
IOException
- if an I/O error occurs
-
visitFileFailed
Invoked for a file that could not be visited.Unless overridden, this method re-throws the I/O exception that prevented the file from being visited.
- Specified by:
visitFileFailed
in interfaceFileVisitor<T>
- Parameters:
file
- a reference to the fileexc
- the I/O exception that prevented the file from being visited- Returns:
- the visit result
- Throws:
IOException
- if an I/O error occurs
-
postVisitDirectory
Invoked for a directory after entries in the directory, and all of their descendants, have been visited.Unless overridden, this method returns
CONTINUE
if the directory iteration completes without an I/O exception; otherwise this method re-throws the I/O exception that caused the iteration of the directory to terminate prematurely.- Specified by:
postVisitDirectory
in interfaceFileVisitor<T>
- Parameters:
dir
- a reference to the directoryexc
-null
if the iteration of the directory completes without an error; otherwise the I/O exception that caused the iteration of the directory to complete prematurely- Returns:
- the visit result
- Throws:
IOException
- if an I/O error occurs
-