Close

Java IO & NIO - Files.newDirectoryStream() Examples

[Last Updated: Oct 30, 2025]

Java IO & NIO Java Java API 

PreviousNext

Class:

java.nio.file.Files

java.lang.Objectjava.lang.Objectjava.nio.file.Filesjava.nio.file.FilesLogicBig

Methods:

public static DirectoryStream<Path> newDirectoryStream(Path dir)
                                                throws IOException

Opens a directory, returning a DirectoryStream which allows to iterate over all entries in the directory.

Parameters:
dir - the path to the directory
Returns:
a new and open DirectoryStream object 


public static DirectoryStream<Path> newDirectoryStream(Path dir,
                                                       String glob)
                                                throws IOException
Parameters:
dir - the path to the directory
glob - the glob pattern to match target files/directories
Returns:
a new and open DirectoryStream object 



public static DirectoryStream<Path> newDirectoryStream(Path dir,
                                                       DirectoryStream.Filter<? super Path> filter)
                                                throws IOException
Parameters:
dir - the path to the directory
filter - the directory stream filter
Returns:
a new and open DirectoryStream object


Examples


package com.logicbig.example.files;

import java.io.IOException;
import java.nio.file.DirectoryStream;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.Iterator;

public class NewDirectoryStreamExample {

    public static void main(String... args) throws IOException {
        String pathString = System.getProperty("java.io.tmpdir");
        Path path = Paths.get(pathString);
        try (DirectoryStream<Path> ds = Files.newDirectoryStream(path)) {
            Iterator<Path> iterator = ds.iterator();
            int c = 0;
            while (iterator.hasNext() && c < 5) {
                Path p = iterator.next();
                System.out.println(p);
                c++;
            }
        }
    }
}

Output

C:\Users\Joe\AppData\Local\Temp\+~JF1283084198655582245.tmp
C:\Users\Joe\AppData\Local\Temp\+~JF192051292487094235.tmp
C:\Users\Joe\AppData\Local\Temp\+~JF2519104209326462184.tmp
C:\Users\Joe\AppData\Local\Temp\+~JF33147415601443728.tmp
C:\Users\Joe\AppData\Local\Temp\+~JF3396327083016795947.tmp




package com.logicbig.example.files;

import java.io.IOException;
import java.nio.file.DirectoryStream;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;

public class NewDirectoryStreamExample2 {

    public static void main(String... args) throws IOException {
        String pathString = System.getProperty("java.io.tmpdir");
        Path path = Paths.get(pathString);
        System.out.println("Path to stream: " + path);
        //stream all files with name ending .log
        try (DirectoryStream<Path> ds = Files.newDirectoryStream(path, "*.log")) {
            ds.forEach(System.out::println);
        }
    }
}

Output

Path to stream: C:\Users\Joe\AppData\Local\Temp
C:\Users\Joe\AppData\Local\Temp\adb.log
C:\Users\Joe\AppData\Local\Temp\aria-debug-1476.log
C:\Users\Joe\AppData\Local\Temp\aria-debug-4092.log
C:\Users\Joe\AppData\Local\Temp\aria-debug-5588.log
C:\Users\Joe\AppData\Local\Temp\JavaDeployReg.log
C:\Users\Joe\AppData\Local\Temp\StructuredQuery.log




package com.logicbig.example.files;

import java.io.IOException;
import java.nio.file.DirectoryStream;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;

public class NewDirectoryStreamExample3 {

    public static void main(String... args) throws IOException {
        String pathString = System.getProperty("java.io.tmpdir");
        Path path = Paths.get(pathString);
        System.out.println("Path to stream: " + path);
        //stream all files with name ending .log
        try (DirectoryStream<Path> ds = Files.newDirectoryStream(path,
                p -> p.getFileName().toString().startsWith("aria"))) {
            ds.forEach(System.out::println);
        }
    }
}

Output

Path to stream: C:\Users\Joe\AppData\Local\Temp
C:\Users\Joe\AppData\Local\Temp\aria-debug-1476.log
C:\Users\Joe\AppData\Local\Temp\aria-debug-4092.log
C:\Users\Joe\AppData\Local\Temp\aria-debug-5588.log

See Also