Java java.nio.file.Files newDirectoryStream() Méthode

Java File Java java.nio.file.Files


java.nio.file.Files.newDirectoryStream()est une méthode très pratique dans le paquetage Java NIO (New I/O), utilisée pour parcourir les fichiers et sous-répertoires d’un répertoire. Comparée auxjava.io.Fileméthodes traditionnelles, elle fournit une méthode de parcours de répertoire plus efficace et flexible.

Définition de méthode

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

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

public static DirectoryStream<Path> newDirectoryStream(Path dir, DirectoryStream.Filter<? super Path> filter) throws IOException

Description du paramètre

1. Paramètres formels de base

  • dir(type Path) : le chemin du répertoire à ouvrir
  • Valeur de retour :DirectoryStream<Path>, un flux d’itération de toutes les entrées du répertoire

2. Paramètres formels avec filtre

  • glob(type String) : un motif glob utilisé pour faire correspondre les noms de fichiers
  • filter(type DirectoryStream.Filter<? super Path>) : interface de filtre personnalisée

Exemples d'utilisation

1. Utilisation de base : parcours d'un répertoire

Exemple

import java.io.IOException;
import java.nio.file.*;
import java.nio.file.attribute.BasicFileAttributes;

public class DirectoryStreamExample {
    public static void main(String[] args) {
        Path dir = Paths.get("C:/example");
       
        try (DirectoryStream<Path> stream = Files.newDirectoryStream(dir)) {
            for (Path file : stream) {
                System.out.println(file.getFileName());
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

2. Filtrage avec des motifs glob

Exemple

// Lister uniquement les fichiers .txt
try (DirectoryStream<Path> stream = Files.newDirectoryStream(dir, "*.txt")) {
    for (Path file : stream) {
        System.out.println(file.getFileName());
    }
}

3. Utilisation d'un filtre personnalisé

Exemple

// Lister uniquement les répertoires
DirectoryStream.Filter<Path> filter = new DirectoryStream.Filter<Path>() {
    @Override
    public boolean accept(Path entry) throws IOException {
        return Files.isDirectory(entry);
    }
};

try (DirectoryStream<Path> stream = Files.newDirectoryStream(dir, filter)) {
    for (Path file : stream) {
        System.out.println(file.getFileName());
    }
}

Caractéristiques de la méthode

1. Efficacité

  • Utilise les fonctionnalités des canaux NIO, comparé aux méthodes traditionnellesFile.listFiles()plus efficace
  • Particulièrement adapté au traitement des répertoires contenant de nombreux fichiers

2. Gestion des ressources

  • Le flux retournéDirectoryStreamimplementsAutoCloseableinterface
  • Il est recommandé d'utiliser l'instruction try-with-resources pour garantir une libération correcte des ressources

3. Sécurité des threads

  • Non thread-safe, ne peut pas être partagé entre plusieurs threads
  • Si un traitement concurrent est nécessaire, un flux distinct doit être créé pour chaque thread

Notes

  1. Gestion des exceptions d'E/S: Doit gérer ou déclarer la levéeIOException
  2. Libération des ressources: Doit fermer le flux pour éviter les fuites de ressources
  3. Considérations de performance: Pour les répertoires très volumineux, envisagez le traitement par lots
  4. Liens symboliques: Par défaut, les liens symboliques sont suivis, sauf configuration spéciale

Comparaison des alternatives

Méthode Avantages Inconvénients
Files.newDirectoryStream() Efficace, prend en charge le filtrage Non sécurisé pour les threads
Files.list() (Java 8+) Retourne un Stream, prend en charge le traitement parallèle Nécessite Java 8+
File.listFiles() Simple et facile à utiliser Performances inférieures

Bonnes pratiques

  1. Utilisez toujours l'instruction try-with-resources
  2. Pour une logique de filtrage complexe, utilisez des filtres personnalisés
  3. Envisagez le traitement par lots lors de la manipulation de grands répertoires
  4. Dans les environnements Java 8+,Files.list()peut être un meilleur choix

FAQ

Q1 : Comment gérer les fichiers cachés ?

Vous pouvez utiliser un filtre personnalisé :

Exemple

DirectoryStream.Filter<Path> filter = entry -> !entry.getFileName().toString().startsWith(".");

Q2 : Comment parcourir récursivement les sous-répertoires ?

newDirectoryStream()Il n'est pas récursif en lui-même ; il peut être combiné avecFiles.walkFileTree()pour implémenter un parcours récursif.

Q3 : Quelles sont les suggestions d'optimisation des performances ?

  • Évitez les opérations coûteuses dans le filtre
  • Pour les opérations en lecture seule, envisagez d'utiliserFiles.list()et les flux parallèles

Grâce à l'explication détaillée dans cet article, vous devriez avoir maîtriséFiles.newDirectoryStream()l'utilisation essentielle et les bonnes pratiques de cette méthode. Cette méthode est un outil très pratique dans les opérations sur les fichiers Java, et une utilisation appropriée peut améliorer considérablement l'efficacité du parcours des répertoires.

Java File Java java.nio.file.Files

Autres extensions