How to delete a directory recursively in Java

In an earlier article, we looked at different ways of deleting a directory in Java. In this article, you'll learn how to delete a non-empty directory recursively — delete all its files and sub-folders.

Java provides multiple methods to delete a directory. However, the directory must be emptied before we delete it. To remove all contents of a particular directory programmatically, we need to use recursion as explained below:

  1. List all contents (files & sub-folders) of the directory to be deleted.
  2. Delete all regular files of the current directory (exist from recursion).
  3. For each sub-folder of the current directory, go back to step 1 (recursive step).
  4. Delete the directory.

Let us look at different ways to implement the above simple recursive algorithm.

Using Files.walk() Method - NIO API

In Java 8 or higher, you can use Files.walk() from NIO API (classes in java.nio.* package) to recursively delete a non-empty directory. This method returns a Stream that can be used to delete all files and sub-folders as shown below:

try {
    // create a stream
    Stream<Path> files = Files.walk(Paths.get("dir"));

    // delete directory including files and sub-folders

    // close the stream

} catch (IOException ex) {

In the above example, Files.walk() returns a Stream of Path. We sorted it in the reverse order to place the paths indicating the contents of directories before directories itself. Afterward, it maps Path to File and deletes each File.

Using Java I/O Package

To delete a non-empty directory using Java legacy I/O API, we need to manually write a recursive function to implement the above algorithm. Here is how it looks like:

public void deleteDir(File dir) {
    File[] files = dir.listFiles();
    if(files != null) {
        for (final File file : files) {

As you can see above, we are using File.listFiles() method to list all files and sub-directories in the directory. For each file, we recursively call deleteDir() method. In the end, we delete the directory using File.delete().

Now you can call the above method as follows:

File dir = new File("dir");

Using Apache Commons IO

The Apache Commons IO library provides FileUtils.deleteDirectory() method to delete a directory recursively including all files and sub-directories:

try {
    // directory path
    File dir  = new File("dir");

    // delete directory recursively

} catch (IOException ex) {

Don't forget to include Apache Commons IO dependency to your Maven's project pom.xml file:


For a Gradle project, add the following dependency to your build.gralde file:

implementation 'commons-io:commons-io:2.6'

Further Reading

You may be interested in other Java I/O articles:

✌️ Like this article? Follow me on Twitter and LinkedIn. You can also subscribe to RSS Feed.

You might also like...

Digital Ocean

The simplest cloud platform for developers & teams. Start with a $200 free credit.

Buy me a coffee ☕

If you enjoy reading my articles and want to help me out paying bills, please consider buying me a coffee ($5) or two ($10). I will be highly grateful to you ✌️

Enter the number of coffees below:

✨ Learn to build modern web applications using JavaScript and Spring Boot

I started this blog as a place to share everything I have learned in the last decade. I write about modern JavaScript, Node.js, Spring Boot, core Java, RESTful APIs, and all things web development.

The newsletter is sent every week and includes early access to clear, concise, and easy-to-follow tutorials, and other stuff I think you'd enjoy! No spam ever, unsubscribe at any time.