Java java.nio.file.Files newDirectoryStream() Méthode
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, 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 fichiersfilter(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.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
try (DirectoryStream<Path> stream = Files.newDirectoryStream(dir, "*.txt")) {
for (Path file : stream) {
System.out.println(file.getFileName());
}
}
3. Utilisation d'un filtre personnalisé
Exemple
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 traditionnelles
File.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
- Gestion des exceptions d'E/S: Doit gérer ou déclarer la levée
IOException - Libération des ressources: Doit fermer le flux pour éviter les fuites de ressources
- Considérations de performance: Pour les répertoires très volumineux, envisagez le traitement par lots
- 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
- Utilisez toujours l'instruction try-with-resources
- Pour une logique de filtrage complexe, utilisez des filtres personnalisés
- Envisagez le traitement par lots lors de la manipulation de grands répertoires
- 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
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'utiliser
Files.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 java.nio.file.Files