How to List Files in Directory in Java: Simple Guide

To list files in a directory in Java, use the java.io.File class and call listFiles() method on a File object representing the directory. This returns an array of File objects for each file and folder inside the directory.

Syntax

The basic syntax to list files in a directory uses the File class from java.io. You create a File object for the directory path, then call listFiles() to get an array of files.

• File dir = new File("path/to/directory"); creates a directory object.
• File[] files = dir.listFiles(); gets all files and folders inside.

java

File dir = new File("path/to/directory");
File[] files = dir.listFiles();

Example

This example shows how to list all files and folders inside a directory and print their names.

java

import java.io.File;

public class ListFilesExample {
    public static void main(String[] args) {
        File dir = new File("."); // current directory
        File[] files = dir.listFiles();

        if (files != null) {
            for (File file : files) {
                System.out.println(file.getName());
            }
        } else {
            System.out.println("Directory does not exist or is not a directory.");
        }
    }
}

Output

ListFilesExample.java
README.md
src
bin

Common Pitfalls

Common mistakes when listing files include:

• Using listFiles() on a File object that is not a directory returns null.
• Not checking for null before using the array causes NullPointerException.
• Using relative paths without knowing the current working directory can cause confusion.

Always check if the directory exists and is a directory before listing files.

java

import java.io.File;

public class WrongWay {
    public static void main(String[] args) {
        File file = new File("somefile.txt");
        File[] files = file.listFiles(); // Wrong: file is not a directory
        System.out.println(files.length); // Causes NullPointerException
    }
}

// Correct way:

public class RightWay {
    public static void main(String[] args) {
        File dir = new File(".");
        if (dir.exists() && dir.isDirectory()) {
            File[] files = dir.listFiles();
            System.out.println("Number of files: " + files.length);
        } else {
            System.out.println("Not a valid directory.");
        }
    }
}

Quick Reference

Summary tips for listing files in Java:

Tip
Use File dir = new File(path) to create directory object.
Call dir.listFiles() to get files array.
Always check dir.exists() and dir.isDirectory() before listing.
Check if listFiles() returns null to avoid errors.
Use file.getName() to get file or folder name.

Key Takeaways

Use java.io.File and listFiles() to get files in a directory.

Always check if the directory exists and is a directory before listing files.

Handle the case when listFiles() returns null to avoid errors.

Use getName() on File objects to get file or folder names.

Relative paths depend on the program's working directory.