List Files in Directory and Subdirectories in Java

📘 Premium Read: Access my best content on Medium member-only articles — deep dives into Java, Spring Boot, Microservices, backend architecture, interview preparation, career advice, and industry-standard best practices.

✅ Some premium posts are free to read — no account needed. Follow me on Medium to stay updated and support my writing.

🎓 Top 10 Udemy Courses (Huge Discount): Explore My Udemy Courses — Learn through real-time, project-based development.

▶️ Subscribe to My YouTube Channel (172K+ subscribers): Java Guides on YouTube

Introduction

In Java, the java.nio.file package provides a powerful API to work with file systems. One common requirement is to list all files in a directory and its subdirectories. This can be achieved using the Files.walk() method, which returns a Stream<Path> that can be used to traverse the file tree. This guide will demonstrate how to list files in a directory and its subdirectories using Java.

Table of Contents

1. Importing Required Packages
2. Listing Files in a Directory and Subdirectories with Files.walk()
3. Handling Exceptions
4. Complete Example
5. Conclusion

Importing Required Packages

To list files in a directory and its subdirectories, you need to import the necessary classes from the java.nio.file package.

Example

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.DirectoryStream;
import java.io.IOException;
import java.util.stream.Collectors;
import java.util.stream.Stream;

Listing Files in a Directory and Subdirectories with Files.walk()

The Files.walk() method generates a stream of paths from the starting file. By default, it visits all levels of the file tree.

Example

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.io.IOException;
import java.util.stream.Stream;

public class ListFilesExample {
    public static void main(String[] args) {
        Path startPath = Paths.get("your_directory_path_here");
        try (Stream<Path> stream = Files.walk(startPath)) {
            stream.filter(Files::isRegularFile)
                  .forEach(System.out::println);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

In the example above, the Files.walk() method generates a stream of Path objects from the starting directory. The stream is filtered to include only regular files, and each file path is printed to the console.

Handling Exceptions

When listing files, several exceptions might be thrown:

• IOException: If an I/O error occurs.
• SecurityException: If a security manager exists and denies access to the file system.

Example with Exception Handling

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.io.IOException;
import java.util.stream.Stream;

public class ListFilesWithExceptionHandlingExample {
    public static void main(String[] args) {
        Path startPath = Paths.get("your_directory_path_here");
        try (Stream<Path> stream = Files.walk(startPath)) {
            stream.filter(Files::isRegularFile)
                  .forEach(System.out::println);
        } catch (IOException e) {
            System.err.println("I/O error: " + e.getMessage());
        } catch (SecurityException e) {
            System.err.println("Access denied: " + e.getMessage());
        }
    }
}

In the example above, different exceptions are caught and handled appropriately, providing informative messages.

Complete Example

Here is a complete example demonstrating how to list files in a directory and its subdirectories using the Files.walk() method with proper exception handling.

ListFilesExample.java

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.io.IOException;
import java.util.stream.Stream;

public class ListFilesExample {
    public static void main(String[] args) {
        Path startPath = Paths.get("your_directory_path_here");
        try (Stream<Path> stream = Files.walk(startPath)) {
            stream.filter(Files::isRegularFile)
                  .forEach(System.out::println);
        } catch (IOException e) {
            System.err.println("I/O error: " + e.getMessage());
        } catch (SecurityException e) {
            System.err.println("Access denied: " + e.getMessage());
        }
    }
}

In this example, all regular files in the specified directory and its subdirectories are listed and printed to the console. The code handles exceptions to ensure that informative messages are displayed if an error occurs.

Conclusion

The Files.walk() method in Java provides a simple and efficient way to list files in a directory and its subdirectories. By understanding how to use this method and handle potential exceptions, you can effectively manage file listing operations in your Java applications. Remember to always handle exceptions appropriately to ensure your application can respond to errors gracefully.