Java java.nio.file.Files createDirectory()Méthode
java.nio.file.Files.createDirectory()est une méthode utilitaire du package Java NIO (New I/O) permettant de créer un nouveau répertoire. Elle appartient à lajava.nio.file.Files, offrant un moyen simple et sûr de créer un seul répertoire.
Définition de méthode
Description du paramètre
dir: Le chemin du répertoire à créer (objet Path)attrs(Facultatif) : Une liste facultative de FileAttribute pour définir les attributs du répertoire (tels que les autorisations)
Valeur de retour
Renvoie l'objet Path du répertoire créé
Exceptions
IOException: Si une erreur d'E/S se produitFileAlreadyExistsException: Si le répertoire existe déjàSecurityException: Si les autorisations sont insuffisantes pour créer le répertoire
Exemple d'utilisation de base
Exemple
public class CreateDirectoryExample {
public static void main(String[] args) {
Path path = Paths.get("C:/test/new_directory");
try {
Files.createDirectory(path);
System.out.println("Répertoire créé avec succès : " + path);
} catch (IOException e) {
System.err.println("Échec de la création du répertoire : " + e.getMessage());
}
}
}
Caractéristiques de la méthode
1. Créer un seul répertoire
createDirectory()Ne peut créer qu'un seul répertoire. Si le répertoire parent dans le chemin n'existe pas, une exception sera levée.NoSuchFileException。
2. Opération atomique
La création de répertoire est une opération atomique ; elle réussit complètement ou échoue complètement.
3. Vérification de l'existence du répertoire
Si le répertoire existe déjà, la méthode lèvera une exception.FileAlreadyExistsException。
Différence avec createDirectories()
FilesLa classe fournit égalementcreateDirectories()méthode. Les principales différences entre les deux sont :
| Fonctionnalité | createDirectory() | createDirectories() |
|---|---|---|
| Créer un seul répertoire | Oui | Oui |
| Créer des répertoires à plusieurs niveaux | non | Oui |
| Lorsque le répertoire parent n'existe pas | Lance une exception | Crée automatiquement les répertoires parents |
| Lorsque le répertoire existe déjà | Lance une exception | Ne lève pas d'exception |
Utilisation avancée
1. Définition des attributs de répertoire
Exemple
import java.nio.file.attribute.PosixFilePermission;
import java.util.Set;
Path path = Paths.get("/path/to/new_directory");
Set<PosixFilePermission> perms = PosixFilePermissions.fromString("rwxr-x---");
FileAttribute<Set<PosixFilePermission>> attr = PosixFilePermissions.asFileAttribute(perms);
Files.createDirectory(path, attr);
2. Gestion des exceptions
Exemple
Files.createDirectory(path);
} catch (FileAlreadyExistsException e) {
System.err.println("Le répertoire existe déjà : " + path);
} catch (NoSuchFileException e) {
System.err.println("Le répertoire parent n'existe pas : " + e.getFile());
} catch (IOException e) {
System.err.println("Autre erreur d'E/S : " + e.getMessage());
}
Bonnes pratiques
- Vérifiez si le répertoire existe: Avant de tenter de le créer, vous pouvez utiliser
Files.exists(path)pour vérifier - Gérez toutes les exceptions possibles: en particulier
FileAlreadyExistsExceptionetNoSuchFileException - **Envisagez d'utiliser createDirectories()** : Si vous devez créer des répertoires à plusieurs niveaux
- Définissez des autorisations appropriées: en particulier dans les systèmes multi-utilisateurs
Résumé
Files.createDirectory()est la méthode recommandée dans Java NIO pour créer un répertoire unique. Elle fournitFile.mkdir()des fonctionnalités plus riches et une meilleure gestion des exceptions. Comprendre cette méthode et sacreateDirectories()différence, ce qui peut aider les développeurs à gérer les opérations du système de fichiers plus efficacement.
Java java.nio.file.Files