Course contentsShow
← Java
Lesson 2063 of 2,87041. NIO.2 and the Path APIFree lesson

Recursive Directory Deletion with walkFileTree

Implement recursive directory deletion by combining Files.walkFileTree with a custom FileVisitor.

Recursive Directory Deletion with walkFileTree

What you'll learn: How to safely delete an entire directory tree by walking through it with a custom FileVisitor.


The Challenge of Deleting Directories

You've learned that Files.delete throws a DirectoryNotEmptyException when you try to delete a directory containing files. The solution? Delete everything inside first, working from the deepest files upward. This is where Files.walkFileTree with a custom FileVisitor shines.

How It Works

Think of it like cleaning out a building: you empty each room (delete files), then remove the rooms themselves (delete subdirectories), and finally tear down the building (delete the root directory). The walkFileTree method visits every file and directory in depth-first order, perfect for this bottom-up deletion strategy.

Here's the pattern:

Path directory = Paths.get("myFolder");

Files.walkFileTree(directory, new SimpleFileVisitor<Path>() {
    @Override
    public FileVisitResult visitFile(Path file, BasicFileAttributes attrs)
            throws IOException {
        Files.delete(file);  // Delete each file
        return FileVisitResult.CONTINUE;
    }

    @Override
    public FileVisitResult postVisitDirectory(Path dir, IOException exc)
            throws IOException {
        Files.delete(dir);  // Delete directory after its contents
        return FileVisitResult.CONTINUE;
    }
});

Why This Works

The key is postVisitDirectory — it's called after all the directory's contents have been visited. By that time, all files and subdirectories inside have already been deleted, so the directory is empty and safe to remove.

The visitFile method handles each individual file, deleting it immediately. Together, they process the entire tree from leaves to root.

Key Takeaway: Combine Files.walkFileTree with a SimpleFileVisitor that deletes files in visitFile and directories in postVisitDirectory to recursively delete entire directory trees safely.