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

Java File Java java.nio.file.Files


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

public static Path createDirectory(Path dir, FileAttribute<?>... attrs) throws IOException

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 produit
  • FileAlreadyExistsException: 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

import java.nio.file.*;

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.PosixFilePermissions;
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

try {
    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

  1. Vérifiez si le répertoire existe: Avant de tenter de le créer, vous pouvez utiliserFiles.exists(path)pour vérifier
  2. Gérez toutes les exceptions possibles: en particulierFileAlreadyExistsExceptionetNoSuchFileException
  3. **Envisagez d'utiliser createDirectories()** : Si vous devez créer des répertoires à plusieurs niveaux
  4. 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 File Java java.nio.file.Files

Autres extensions