DataLakeDirectoryClient Classe

Paquet:

com.azure.storage.file.datalake

Artefact Maven:

com.azure:azure-storage-file-datalake:12.19.0

• java.lang.Object
• • com.azure.storage.file.datalake.DataLakePathClient
  • • com.azure.storage.file.datalake.DataLakeDirectoryClient

public class DataLakeDirectoryClient
extends DataLakePathClient

Cette classe fournit un client qui contient des opérations d’annuaire pour Azure Storage Data Lake. Les opérations fournies par ce client incluent la création d’un répertoire, la suppression d’un répertoire, le renommage d’un répertoire, la définition de métadonnées et d’en-têtes HTTP, la définition et la récupération du contrôle d’accès, l’obtention de propriétés et la création et la suppression de fichiers et de sous-répertoires.

Ce client est instancié via DataLakePathClientBuilder ou récupéré via getDirectoryClient(String directoryName).

Pour plus d’informations, consultez Azure Docs .

Résumé de la méthode

Modificateur et type	Méthode et description
DataLakeFileClient	createFile(String fileName) Crée un fichier dans un répertoire.
DataLakeFileClient	createFile(String fileName, boolean overwrite) Crée un fichier dans un répertoire.
DataLakeFileClient	createFileIfNotExists(String fileName) Crée un fichier dans un répertoire s’il n’existe pas.
Response<DataLakeFileClient>	createFileIfNotExistsWithResponse(String fileName, DataLakePathCreateOptions options, Duration timeout, Context context) Crée un fichier dans un répertoire s’il n’existe pas.
Response<DataLakeFileClient>	createFileWithResponse(String fileName, DataLakePathCreateOptions options, Duration timeout, Context context) Crée un fichier dans un répertoire.
Response<DataLakeFileClient>	createFileWithResponse(String fileName, String permissions, String umask, PathHttpHeaders headers, Map<String,String> metadata, DataLakeRequestConditions requestConditions, Duration timeout, Context context) Crée un fichier dans un répertoire.
DataLakeDirectoryClient	createSubdirectory(String subdirectoryName) Crée un sous-répertoire dans un répertoire.
DataLakeDirectoryClient	createSubdirectory(String subdirectoryName, boolean overwrite) Crée un sous-répertoire dans un répertoire.
DataLakeDirectoryClient	createSubdirectoryIfNotExists(String subdirectoryName) Crée un sous-répertoire s’il n’existe pas dans un répertoire.
Response<DataLakeDirectoryClient>	createSubdirectoryIfNotExistsWithResponse(String subdirectoryName, DataLakePathCreateOptions options, Duration timeout, Context context) Crée un sous-répertoire dans un répertoire s’il n’existe pas.
Response<DataLakeDirectoryClient>	createSubdirectoryWithResponse(String subdirectoryName, DataLakePathCreateOptions options, Duration timeout, Context context) Crée un sous-répertoire dans un répertoire.
Response<DataLakeDirectoryClient>	createSubdirectoryWithResponse(String subdirectoryName, String permissions, String umask, PathHttpHeaders headers, Map<String,String> metadata, DataLakeRequestConditions requestConditions, Duration timeout, Context context) Crée un sous-répertoire dans un répertoire.
void	delete() Supprime un répertoire.
void	deleteFile(String fileName) Supprime le fichier spécifié dans le répertoire .
boolean	deleteFileIfExists(String fileName) Supprime le fichier spécifié dans le répertoire s’il existe.
Response<Boolean>	deleteFileIfExistsWithResponse(String fileName, DataLakePathDeleteOptions options, Duration timeout, Context context) Supprime le fichier spécifié dans le répertoire s’il existe.
Response<Void>	deleteFileWithResponse(String fileName, DataLakeRequestConditions requestConditions, Duration timeout, Context context) Supprime le fichier spécifié dans le répertoire.
boolean	deleteIfExists() Supprime un répertoire s’il existe.
Response<Boolean>	deleteIfExistsWithResponse(DataLakePathDeleteOptions options, Duration timeout, Context context) Supprime un répertoire s’il existe.
void	deleteRecursively() Supprime de manière récursive un répertoire et tout le contenu du répertoire.
Response<Void>	deleteRecursivelyWithResponse(DataLakeRequestConditions requestConditions, Duration timeout, Context context) Supprime de manière récursive un répertoire et tout le contenu du répertoire.
void	deleteSubdirectory(String subdirectoryName) Supprime le sous-répertoire spécifié dans le répertoire.
boolean	deleteSubdirectoryIfExists(String subdirectoryName) Supprime le sous-répertoire spécifié dans le répertoire s’il existe.
Response<Boolean>	deleteSubdirectoryIfExistsWithResponse(String subdirectoryName, DataLakePathDeleteOptions options, Duration timeout, Context context) Supprime le sous-répertoire spécifié dans le répertoire s’il existe.
Response<Void>	deleteSubdirectoryWithResponse(String subdirectoryName, boolean recursive, DataLakeRequestConditions requestConditions, Duration timeout, Context context) Supprime le sous-répertoire spécifié dans le répertoire.
Response<Void>	deleteWithResponse(boolean recursive, DataLakeRequestConditions requestConditions, Duration timeout, Context context) Supprime un répertoire.
DataLakeDirectoryClient	getCustomerProvidedKeyClient(CustomerProvidedKey customerProvidedKey) Crée un nouveau DataLakeDirectoryClient avec le customerProvidedKey spécifié.
String	getDirectoryName() Obtient le nom de ce répertoire, sans inclure son chemin d’accès complet.
String	getDirectoryPath() Obtient le chemin d’accès de ce répertoire, sans inclure le nom de la ressource elle-même.
String	getDirectoryUrl() Obtient l’URL du répertoire représenté par ce client sur le service Data Lake.
DataLakeFileClient	getFileClient(String fileName) Initialise un nouvel objet client DataLakeFileen concaténant le nom du fichierà la fin de l’URL du client DataLakeDirectory.
DataLakeDirectoryClient	getSubdirectoryClient(String subdirectoryName) Initialise un nouvel objet Client DataLakeDirectoryen concaténant le nom du répertoireà la fin de l’URL du client DataLakeDirectory.
PagedIterable<PathItem>	listPaths() Retourne une liste chargée différée de fichiers/répertoires dans ce répertoire.
PagedIterable<PathItem>	listPaths(boolean recursive, boolean userPrincipleNameReturned, Integer maxResults, Duration timeout) Retourne une liste chargée différée de fichiers/répertoires dans ce répertoire.
DataLakeDirectoryClient	rename(String destinationFileSystem, String destinationPath) Déplace le répertoire vers un autre emplacement dans le système de fichiers.
Response<DataLakeDirectoryClient>	renameWithResponse(String destinationFileSystem, String destinationPath, DataLakeRequestConditions sourceRequestConditions, DataLakeRequestConditions destinationRequestConditions, Duration timeout, Context context) Déplace le répertoire vers un autre emplacement dans le système de fichiers.

Méthodes héritées de DataLakePathClient

create create createIfNotExists createIfNotExistsWithResponse createWithResponse createWithResponse deleteIfExists deleteIfExistsWithResponse exists existsWithResponse generateSas generateSas generateUserDelegationSas generateUserDelegationSas getAccessControl getAccessControlWithResponse getAccountName getCustomerProvidedKey getCustomerProvidedKeyClient getFileSystemName getHttpPipeline getProperties getProperties getPropertiesWithResponse getServiceVersion removeAccessControlRecursive removeAccessControlRecursiveWithResponse setAccessControlList setAccessControlListWithResponse setAccessControlRecursive setAccessControlRecursiveWithResponse setHttpHeaders setHttpHeadersWithResponse setMetadata setMetadataWithResponse setPermissions setPermissionsWithResponse updateAccessControlRecursive updateAccessControlRecursiveWithResponse

Méthodes héritées de java.lang.Object

clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Détails de la méthode

createFile

public DataLakeFileClient createFile(String fileName)

Crée un fichier dans un répertoire. Par défaut, cette méthode ne remplace pas un fichier existant. Pour plus d’informations, consultez Azure Docs.

Exemples de code

DataLakeFileClient fileClient = client.createFile(fileName);

Parameters:

fileName - Nom du fichier à créer.

Returns:

DataLakeFileClient utilisé pour interagir avec le fichier créé.

createFile

public DataLakeFileClient createFile(String fileName, boolean overwrite)

Crée un fichier dans un répertoire. Pour plus d’informations, consultez Azure Docs.

Exemples de code

boolean overwrite = false; /* Default value. */
 DataLakeFileClient fClient = client.createFile(fileName, overwrite);

Parameters:

fileName - Nom du fichier à créer.

overwrite - Indique s’il faut remplacer ou non un fichier.

Returns:

DataLakeFileClient utilisé pour interagir avec le fichier créé.

createFileIfNotExists

public DataLakeFileClient createFileIfNotExists(String fileName)

Crée un fichier dans un répertoire s’il n’existe pas. Pour plus d’informations, consultez Azure Docs.

Exemples de code

DataLakeFileClient fileClient = client.createFileIfNotExists(fileName);

Parameters:

fileName - Nom du fichier à créer.

Returns:

DataLakeFileClient utilisé pour interagir avec le fichier créé.

createFileIfNotExistsWithResponse

public Response createFileIfNotExistsWithResponse(String fileName, DataLakePathCreateOptions options, Duration timeout, Context context)

Crée un fichier dans un répertoire s’il n’existe pas. Pour plus d’informations, consultez Azure Docs.

Exemples de code

PathHttpHeaders headers = new PathHttpHeaders().setContentLanguage("en-US").setContentType("binary");
 String permissions = "permissions";
 String umask = "umask";
 DataLakePathCreateOptions options = new DataLakePathCreateOptions()
     .setPermissions(permissions)
     .setUmask(umask)
     .setPathHttpHeaders(headers)
     .setMetadata(Collections.singletonMap("metadata", "value"));

 Response<DataLakeFileClient> response = client.createFileIfNotExistsWithResponse(fileName, options, timeout,
     new Context(key1, value1));
 if (response.getStatusCode() == 409) {
     System.out.println("Already existed.");
 } else {
     System.out.printf("Create completed with status %d%n", response.getStatusCode());
 }

Parameters:

fileName - Nom du fichier à créer.

options - DataLakePathCreateOptions clé ou valeur de métadonnées, elle doit être supprimée ou encodée.

timeout - Valeur de délai d’expiration facultative au-delà de laquelle un RuntimeException sera déclenché.

context - Contexte supplémentaire transmis via le pipeline Http pendant l’appel de service.

Returns:

Response<T> dont value contient le DataLakeFileAsyncClient utilisé pour interagir avec le fichier créé. Si Response<T>le code status est 201, un nouveau fichier a été créé avec succès. Si status code est 409, un fichier portant le même nom existait déjà à cet emplacement.

createFileWithResponse

public Response createFileWithResponse(String fileName, DataLakePathCreateOptions options, Duration timeout, Context context)

Crée un fichier dans un répertoire. Si un fichier portant le même nom existe déjà, le fichier est remplacé. Pour plus d’informations, consultez Azure Docs.

Exemples de code

PathHttpHeaders httpHeaders = new PathHttpHeaders()
     .setContentLanguage("en-US")
     .setContentType("binary");
 DataLakeRequestConditions requestConditions = new DataLakeRequestConditions()
     .setLeaseId(leaseId);
 Map<String, String> metadata = Collections.singletonMap("metadata", "value");
 String permissions = "permissions";
 String umask = "umask";
 String owner = "rwx";
 String group = "r--";
 String leaseId = CoreUtils.randomUuid().toString();
 Integer duration = 15;
 DataLakePathCreateOptions options = new DataLakePathCreateOptions()
     .setPermissions(permissions)
     .setUmask(umask)
     .setOwner(owner)
     .setGroup(group)
     .setPathHttpHeaders(httpHeaders)
     .setRequestConditions(requestConditions)
     .setMetadata(metadata)
     .setProposedLeaseId(leaseId)
     .setLeaseDuration(duration);

 Response<DataLakeFileClient> newFileClient = client.createFileWithResponse(fileName, options, timeout,
     new Context(key1, value1));

Parameters:

fileName - Nom du fichier à créer.

options - DataLakePathCreateOptions

timeout - Valeur de délai d’expiration facultative au-delà de laquelle un RuntimeException sera déclenché.

context - Contexte supplémentaire transmis via le pipeline Http pendant l’appel de service.

Returns:

Response<T> dont value contient le DataLakeFileClient utilisé pour interagir avec le fichier créé.

createFileWithResponse

public Response createFileWithResponse(String fileName, String permissions, String umask, PathHttpHeaders headers, Map metadata, DataLakeRequestConditions requestConditions, Duration timeout, Context context)

Crée un fichier dans un répertoire. Si un fichier portant le même nom existe déjà, le fichier est remplacé. Pour plus d’informations, consultez Azure Docs.

Exemples de code

PathHttpHeaders httpHeaders = new PathHttpHeaders()
     .setContentLanguage("en-US")
     .setContentType("binary");
 DataLakeRequestConditions requestConditions = new DataLakeRequestConditions()
     .setLeaseId(leaseId);
 String permissions = "permissions";
 String umask = "umask";
 Response<DataLakeFileClient> newFileClient = client.createFileWithResponse(fileName, permissions, umask, httpHeaders,
     Collections.singletonMap("metadata", "value"), requestConditions,
     timeout, new Context(key1, value1));

Parameters:

fileName - Nom du fichier à créer.

permissions - Autorisations d’accès POSIX pour le propriétaire du fichier, le groupe propriétaire du fichier, etc.

umask - Limite les autorisations du fichier à créer.

headers - PathHttpHeaders

metadata - Métadonnées à associer au fichier. S’il existe un espace blanc de début ou de fin dans une clé ou une valeur de métadonnées, il doit être supprimé ou encodé.

requestConditions - DataLakeRequestConditions

timeout - Valeur de délai d’expiration facultative au-delà de laquelle un RuntimeException sera déclenché.

context - Contexte supplémentaire transmis via le pipeline Http pendant l’appel de service.

Returns:

Response<T> dont value contient le DataLakeFileClient utilisé pour interagir avec le fichier créé.

createSubdirectory

public DataLakeDirectoryClient createSubdirectory(String subdirectoryName)

Crée un sous-répertoire dans un répertoire. Par défaut, cette méthode ne remplace pas un sous-répertoire existant. Pour plus d’informations, consultez Azure Docs.

Exemples de code

DataLakeDirectoryClient directoryClient = client.createSubdirectory(directoryName);

Parameters:

subdirectoryName - Nom du sous-répertoire à créer.

Returns:

DataLakeDirectoryClient utilisé pour interagir avec le sous-répertoire créé.

createSubdirectory

public DataLakeDirectoryClient createSubdirectory(String subdirectoryName, boolean overwrite)

Crée un sous-répertoire dans un répertoire. Pour plus d’informations, consultez Azure Docs.

Exemples de code

boolean overwrite = false; /* Default value. */
 DataLakeDirectoryClient dClient = client.createSubdirectory(fileName, overwrite);

Parameters:

subdirectoryName - Nom du sous-répertoire à créer.

overwrite - Indique s’il faut remplacer ou non le sous-répertoire.

Returns:

DataLakeDirectoryClient utilisé pour interagir avec le sous-répertoire créé.

createSubdirectoryIfNotExists

public DataLakeDirectoryClient createSubdirectoryIfNotExists(String subdirectoryName)

Crée un sous-répertoire s’il n’existe pas dans un répertoire. Pour plus d’informations, consultez Azure Docs.

Exemples de code

DataLakeDirectoryClient directoryClient = client.createSubdirectoryIfNotExists(directoryName);

Parameters:

subdirectoryName - Nom du sous-répertoire à créer.

Returns:

DataLakeDirectoryClient utilisé pour interagir avec le sous-répertoire créé.

createSubdirectoryIfNotExistsWithResponse

public Response createSubdirectoryIfNotExistsWithResponse(String subdirectoryName, DataLakePathCreateOptions options, Duration timeout, Context context)

Crée un sous-répertoire dans un répertoire s’il n’existe pas. Pour plus d’informations, consultez Azure Docs.

Exemples de code

PathHttpHeaders headers = new PathHttpHeaders()
     .setContentLanguage("en-US")
     .setContentType("binary");
 String permissions = "permissions";
 String umask = "umask";
 DataLakePathCreateOptions options = new DataLakePathCreateOptions()
     .setPermissions(permissions)
     .setUmask(umask)
     .setPathHttpHeaders(headers)
     .setMetadata(Collections.singletonMap("metadata", "value"));

 Response<DataLakeDirectoryClient> response = client.createSubdirectoryIfNotExistsWithResponse(directoryName,
     options, timeout, new Context(key1, value1));
 if (response.getStatusCode() == 409) {
     System.out.println("Already existed.");
 } else {
     System.out.printf("Create completed with status %d%n", response.getStatusCode());
 }

Parameters:

subdirectoryName - Nom du sous-répertoire à créer.

options - DataLakePathCreateOptions

timeout - Valeur de délai d’expiration facultative au-delà de laquelle un RuntimeException sera déclenché.

context - Contexte supplémentaire transmis via le pipeline Http pendant l’appel de service.

Returns:

Response<T> dont value contient le DataLakeDirectoryClient utilisé pour interagir avec le sous-répertoire créé. Si Response<T>le code status est 201, un sous-répertoire a été créé avec succès. Si status code est 409, un sous-répertoire portant le même nom existait déjà à cet emplacement.

createSubdirectoryWithResponse

public Response createSubdirectoryWithResponse(String subdirectoryName, DataLakePathCreateOptions options, Duration timeout, Context context)

Crée un sous-répertoire dans un répertoire. Si un sous-répertoire portant le même nom existe déjà, le sous-répertoire est remplacé. Pour plus d’informations, consultez Azure Docs.

Exemples de code

PathHttpHeaders httpHeaders = new PathHttpHeaders()
     .setContentLanguage("en-US")
     .setContentType("binary");
 DataLakeRequestConditions requestConditions = new DataLakeRequestConditions()
     .setLeaseId(leaseId);
 Map<String, String> metadata = Collections.singletonMap("metadata", "value");
 String permissions = "permissions";
 String umask = "umask";
 String owner = "rwx";
 String group = "r--";
 String leaseId = CoreUtils.randomUuid().toString();
 Integer duration = 15;
 DataLakePathCreateOptions options = new DataLakePathCreateOptions()
     .setPermissions(permissions)
     .setUmask(umask)
     .setOwner(owner)
     .setGroup(group)
     .setPathHttpHeaders(httpHeaders)
     .setRequestConditions(requestConditions)
     .setMetadata(metadata)
     .setProposedLeaseId(leaseId)
     .setLeaseDuration(duration);

 Response<DataLakeDirectoryClient> newDirectoryClient = client.createSubdirectoryWithResponse(directoryName,
     options, timeout, new Context(key1, value1));

Parameters:

subdirectoryName - Nom du sous-répertoire à créer.

options - DataLakePathCreateOptions

timeout - Valeur de délai d’expiration facultative au-delà de laquelle un RuntimeException sera déclenché.

context - Contexte supplémentaire transmis via le pipeline Http pendant l’appel de service.

Returns:

Response<T> dont value contient un DataLakeDirectoryClient utilisé pour interagir avec le sous-répertoire créé.

createSubdirectoryWithResponse

public Response createSubdirectoryWithResponse(String subdirectoryName, String permissions, String umask, PathHttpHeaders headers, Map metadata, DataLakeRequestConditions requestConditions, Duration timeout, Context context)

Crée un sous-répertoire dans un répertoire. Si un sous-répertoire portant le même nom existe déjà, le sous-répertoire est remplacé. Pour plus d’informations, consultez Azure Docs.

Exemples de code

PathHttpHeaders httpHeaders = new PathHttpHeaders()
     .setContentLanguage("en-US")
     .setContentType("binary");
 DataLakeRequestConditions requestConditions = new DataLakeRequestConditions()
     .setLeaseId(leaseId);
 String permissions = "permissions";
 String umask = "umask";
 Response<DataLakeDirectoryClient> newDirectoryClient = client.createSubdirectoryWithResponse(directoryName,
     permissions, umask, httpHeaders, Collections.singletonMap("metadata", "value"), requestConditions, timeout,
     new Context(key1, value1));

Parameters:

subdirectoryName - Nom du sous-répertoire à créer.

permissions - Autorisations d’accès POSIX pour le propriétaire du sous-répertoire, le groupe propriétaire du sous-répertoire, etc.

umask - Limite les autorisations du sous-répertoire à créer.

headers - PathHttpHeaders

metadata - Métadonnées à associer à la ressource. S’il existe un espace blanc de début ou de fin dans une clé ou une valeur de métadonnées, il doit être supprimé ou encodé.

requestConditions - DataLakeRequestConditions

timeout - Valeur de délai d’expiration facultative au-delà de laquelle un RuntimeException sera déclenché.

context - Contexte supplémentaire transmis via le pipeline Http pendant l’appel de service.

Returns:

Response<T> dont value contient un DataLakeDirectoryClient utilisé pour interagir avec le sous-répertoire créé.

delete

public void delete()

Supprime un répertoire.

Exemples de code

client.delete();
 System.out.println("Delete request completed");

Pour plus d’informations, consultez Azure Docs.

deleteFile

public void deleteFile(String fileName)

Supprime le fichier spécifié dans le répertoire . Si le fichier n’existe pas, l’opération échoue. Pour plus d’informations, consultez Azure Docs.

Exemples de code

client.deleteFile(fileName);
 System.out.println("Delete request completed");

Parameters:

fileName - Nom du fichier à supprimer.

deleteFileIfExists

public boolean deleteFileIfExists(String fileName)

Supprime le fichier spécifié dans le répertoire s’il existe. Pour plus d’informations, consultez Azure Docs.

Exemples de code

boolean result = client.deleteFileIfExists(fileName);
 System.out.println("Delete request completed: " + result);

Parameters:

fileName - Nom du fichier à supprimer.

Returns:

true si le fichier est supprimé avec succès, false si le fichier n’existe pas.

deleteFileIfExistsWithResponse

public Response deleteFileIfExistsWithResponse(String fileName, DataLakePathDeleteOptions options, Duration timeout, Context context)

Supprime le fichier spécifié dans le répertoire s’il existe. Pour plus d’informations, consultez Azure Docs.

Exemples de code

DataLakeRequestConditions requestConditions = new DataLakeRequestConditions()
     .setLeaseId(leaseId);
 DataLakePathDeleteOptions options = new DataLakePathDeleteOptions().setIsRecursive(false)
     .setRequestConditions(requestConditions);

 Response<Boolean> response = client.deleteFileIfExistsWithResponse(fileName, options, timeout,
     new Context(key1, value1));
 if (response.getStatusCode() == 404) {
     System.out.println("Does not exist.");
 } else {
     System.out.printf("Delete completed with status %d%n", response.getStatusCode());
 }

Parameters:

fileName - Nom du fichier à supprimer.

options - DataLakePathDeleteOptions

timeout - Valeur de délai d’expiration facultative au-delà de laquelle un RuntimeException sera déclenché.

context - Contexte supplémentaire transmis via le pipeline Http pendant l’appel de service.

Returns:

Réponse contenant du code status et des en-têtes HTTP. Si Response<T>le code status est 200, le fichier spécifié a été supprimé. Si status code est 404, le fichier spécifié n’existe pas.

deleteFileWithResponse

public Response deleteFileWithResponse(String fileName, DataLakeRequestConditions requestConditions, Duration timeout, Context context)

Supprime le fichier spécifié dans le répertoire. Si le fichier n’existe pas, l’opération échoue. Pour plus d’informations, consultez Azure Docs.

Exemples de code

DataLakeRequestConditions requestConditions = new DataLakeRequestConditions()
     .setLeaseId(leaseId);

 client.deleteFileWithResponse(fileName, requestConditions, timeout, new Context(key1, value1));
 System.out.println("Delete request completed");

Parameters:

fileName - Nom du fichier à supprimer.

requestConditions - DataLakeRequestConditions

timeout - Valeur de délai d’expiration facultative au-delà de laquelle un RuntimeException sera déclenché.

context - Contexte supplémentaire transmis via le pipeline Http pendant l’appel de service.

Returns:

Réponse contenant du code status et des en-têtes HTTP

deleteIfExists

public boolean deleteIfExists()

Supprime un répertoire s’il existe.

Exemples de code

boolean result = client.deleteIfExists();
 System.out.println("Delete request completed: " + result);

Pour plus d’informations, consultez Azure Docs

Overrides:

DataLakeDirectoryClient.deleteIfExists()

Returns:

true si le répertoire est supprimé avec succès, false si le répertoire n’existe pas.

deleteIfExistsWithResponse

public Response deleteIfExistsWithResponse(DataLakePathDeleteOptions options, Duration timeout, Context context)

Supprime un répertoire s’il existe.

Exemples de code

DataLakeRequestConditions requestConditions = new DataLakeRequestConditions()
     .setLeaseId(leaseId);
 boolean recursive = false; // Default value
 DataLakePathDeleteOptions options = new DataLakePathDeleteOptions().setIsRecursive(recursive)
     .setRequestConditions(requestConditions);

 Response<Boolean> response = client.deleteIfExistsWithResponse(options, timeout, new Context(key1, value1));
 if (response.getStatusCode() == 404) {
     System.out.println("Does not exist.");
 } else {
     System.out.printf("Delete completed with status %d%n", response.getStatusCode());
 }

Pour plus d’informations, consultez Azure Docs

Overrides:

DataLakeDirectoryClient.deleteIfExistsWithResponse(DataLakePathDeleteOptions options, Duration timeout, Context context)

Parameters:

options - DataLakePathDeleteOptions

timeout - Valeur de délai d’expiration facultative au-delà de laquelle un RuntimeException sera déclenché.

context - Contexte supplémentaire transmis via le pipeline Http pendant l’appel de service.

Returns:

Réponse contenant du code status et des en-têtes HTTP. Si Response<T>le code de status est 200, le répertoire a été supprimé. Si status code est 404, le répertoire n’existe pas.

deleteRecursively

public void deleteRecursively()

Supprime de manière récursive un répertoire et tout le contenu du répertoire.

Exemples de code

client.deleteRecursively();
 System.out.println("Delete request completed");

Pour plus d’informations, consultez Azure Docs

deleteRecursivelyWithResponse

public Response deleteRecursivelyWithResponse(DataLakeRequestConditions requestConditions, Duration timeout, Context context)

Supprime de manière récursive un répertoire et tout le contenu du répertoire.

Exemples de code

DataLakeRequestConditions deleteRequestConditions = new DataLakeRequestConditions()
     .setLeaseId(leaseId);
 client.deleteRecursivelyWithResponse(deleteRequestConditions, timeout, new Context(key1, value1));
 System.out.println("Delete request completed");

Pour plus d’informations, consultez Azure Docs

Parameters:

requestConditions - DataLakeRequestConditions

timeout - Valeur de délai d’expiration facultative au-delà de laquelle un RuntimeException sera déclenché.

context - Contexte supplémentaire transmis via le pipeline Http pendant l’appel de service.

Returns:

Achèvement de la signalisation de réponse réactive.

deleteSubdirectory

public void deleteSubdirectory(String subdirectoryName)

Supprime le sous-répertoire spécifié dans le répertoire. Si le sous-répertoire n’existe pas ou n’est pas vide, l’opération échoue. Pour plus d’informations, consultez Azure Docs.

Exemples de code

client.deleteSubdirectory(directoryName);
 System.out.println("Delete request completed");

Parameters:

subdirectoryName - Nom du sous-répertoire à supprimer.

deleteSubdirectoryIfExists

public boolean deleteSubdirectoryIfExists(String subdirectoryName)

Supprime le sous-répertoire spécifié dans le répertoire s’il existe. Pour plus d’informations, consultez Azure Docs.

Exemples de code

boolean result = client.deleteSubdirectoryIfExists(directoryName);
 System.out.println("Delete request completed: " + result);

Parameters:

subdirectoryName - Nom du sous-répertoire à supprimer.

Returns:

true si le sous-répertoire est supprimé avec succès, false si le sous-répertoire n’existe pas.

deleteSubdirectoryIfExistsWithResponse

public Response deleteSubdirectoryIfExistsWithResponse(String subdirectoryName, DataLakePathDeleteOptions options, Duration timeout, Context context)

Supprime le sous-répertoire spécifié dans le répertoire s’il existe. Pour plus d’informations, consultez Azure Docs.

Exemples de code

DataLakeRequestConditions requestConditions = new DataLakeRequestConditions()
     .setLeaseId(leaseId);
 boolean recursive = false; // Default value
 DataLakePathDeleteOptions options = new DataLakePathDeleteOptions().setIsRecursive(recursive)
     .setRequestConditions(requestConditions);

 Response<Boolean> response = client.deleteSubdirectoryIfExistsWithResponse(directoryName, options,
     timeout, new Context(key1, value1));
 if (response.getStatusCode() == 404) {
     System.out.println("Does not exist.");
 } else {
     System.out.printf("Delete completed with status %d%n", response.getStatusCode());
 }

Parameters:

subdirectoryName - Nom du sous-répertoire à supprimer.

options - DataLakePathDeleteOptions

timeout - Valeur de délai d’expiration facultative au-delà de laquelle un RuntimeException sera déclenché.

context - Contexte supplémentaire transmis via le pipeline Http pendant l’appel de service.

Returns:

Réponse contenant du code status et des en-têtes HTTP. Si Response<T>le code status est 200, le sous-répertoire spécifié a été supprimé. Si status code est 404, le sous-répertoire spécifié n’existe pas.

deleteSubdirectoryWithResponse

public Response deleteSubdirectoryWithResponse(String subdirectoryName, boolean recursive, DataLakeRequestConditions requestConditions, Duration timeout, Context context)

Supprime le sous-répertoire spécifié dans le répertoire. Si le sous-répertoire n’existe pas ou n’est pas vide, l’opération échoue. Pour plus d’informations, consultez Azure Docs.

Exemples de code

DataLakeRequestConditions requestConditions = new DataLakeRequestConditions()
     .setLeaseId(leaseId);
 boolean recursive = false; // Default value

 client.deleteSubdirectoryWithResponse(directoryName, recursive, requestConditions, timeout,
     new Context(key1, value1));
 System.out.println("Delete request completed");

Parameters:

subdirectoryName - Nom du sous-répertoire à supprimer.

recursive - Indique s’il faut supprimer ou non tous les chemins d’accès sous le sous-répertoire.

requestConditions - DataLakeRequestConditions

timeout - Valeur de délai d’expiration facultative au-delà de laquelle un RuntimeException sera déclenché.

context - Contexte supplémentaire transmis via le pipeline Http pendant l’appel de service.

Returns:

Réponse contenant du code status et des en-têtes HTTP

deleteWithResponse

public Response deleteWithResponse(boolean recursive, DataLakeRequestConditions requestConditions, Duration timeout, Context context)

Supprime un répertoire.

Exemples de code

DataLakeRequestConditions requestConditions = new DataLakeRequestConditions()
     .setLeaseId(leaseId);
 boolean recursive = false; // Default value

 client.deleteWithResponse(recursive, requestConditions, timeout, new Context(key1, value1));
 System.out.println("Delete request completed");

Pour plus d’informations, consultez Azure Docs

Parameters:

recursive - Indique s’il faut supprimer ou non tous les chemins d’accès sous le répertoire.

requestConditions - DataLakeRequestConditions

timeout - Valeur de délai d’expiration facultative au-delà de laquelle un RuntimeException sera déclenché.

context - Contexte supplémentaire transmis via le pipeline Http pendant l’appel de service.

Returns:

Achèvement de la signalisation de réponse réactive.

getCustomerProvidedKeyClient

public DataLakeDirectoryClient getCustomerProvidedKeyClient(CustomerProvidedKey customerProvidedKey)

Crée un nouveau DataLakeDirectoryClient avec le customerProvidedKey spécifié.

Overrides:

DataLakeDirectoryClient.getCustomerProvidedKeyClient(CustomerProvidedKey customerProvidedKey)

Parameters:

customerProvidedKey - pour le répertoire, passez null à n’utiliser aucune clé fournie par le CustomerProvidedKey client.

Returns:

avec DataLakeDirectoryClient le spécifié customerProvidedKey.

getDirectoryName

public String getDirectoryName()

Obtient le nom de ce répertoire, sans inclure son chemin d’accès complet.

Returns:

Nom du répertoire.

getDirectoryPath

public String getDirectoryPath()

Obtient le chemin d’accès de ce répertoire, sans inclure le nom de la ressource elle-même.

Returns:

Chemin du répertoire.

getDirectoryUrl

public String getDirectoryUrl()

Obtient l’URL du répertoire représenté par ce client sur le service Data Lake.

Returns:

l’URL.

getFileClient

public DataLakeFileClient getFileClient(String fileName)

Initialise un nouvel objet DataLakeFileClient en concaténant fileName à la fin de l’URL de DataLakeDirectoryClient. Le nouveau DataLakeFileClient utilise le même pipeline de stratégie de requête que DataLakeDirectoryClient.

Parameters:

fileName - String représentant le nom du fichier. Exemples de code

 DataLakeFileClient dataLakeFileClient = client.getFileClient(fileName);
 

Returns:

Nouvel DataLakeFileClient objet qui fait référence au fichier portant le nom spécifié dans ce répertoire.

getSubdirectoryClient

public DataLakeDirectoryClient getSubdirectoryClient(String subdirectoryName)

Initialise un nouvel objet DataLakeDirectoryClient en concaténant directoryName à la fin de l’URL de DataLakeDirectoryClient. Le nouveau DataLakeDirectoryClient utilise le même pipeline de stratégie de requête que le DataLakeDirectoryClient.

Parameters:

subdirectoryName - String représentant le nom du sous-répertoire. Exemples de code

 DataLakeDirectoryClient dataLakeDirectoryClient = client.getSubdirectoryClient(directoryName);
 

Returns:

Nouvel DataLakeDirectoryClient objet qui fait référence au sous-répertoire avec le nom spécifié dans ce répertoire

listPaths

public PagedIterable listPaths()

Retourne une liste chargée différée de fichiers/répertoires dans ce répertoire. Le retourné PagedIterable<T> peut être consommé pendant que les nouveaux éléments sont récupérés automatiquement en fonction des besoins. Pour plus d’informations, consultez Azure Docs.

Exemples de code

client.listPaths().forEach(path -> System.out.printf("Name: %s%n", path.getName()));

Returns:

Liste des fichiers/répertoires.

listPaths

public PagedIterable listPaths(boolean recursive, boolean userPrincipleNameReturned, Integer maxResults, Duration timeout)

Retourne une liste chargée différée de fichiers/répertoires dans ce répertoire. Le retourné PagedIterable<T> peut être consommé pendant que les nouveaux éléments sont récupérés automatiquement en fonction des besoins. Pour plus d’informations, consultez Azure Docs.

Exemples de code

client.listPaths(false, false, 10, timeout)
     .forEach(path -> System.out.printf("Name: %s%n", path.getName()));

Parameters:

recursive - Spécifie si l’appel doit inclure tous les chemins d’accès de manière récursive.

userPrincipleNameReturned - Si la valeur est « true », les valeurs d’identité utilisateur retournées dans les en-têtes de réponse x-ms-owner, x-ms-group et x-ms-acl sont transformées des ID d’objet Azure Active Directory en noms d’utilisateur principal. Si « false », les valeurs sont retournées en tant qu’ID d’objet Azure Active Directory. La valeur par défaut est false. Notez que les ID d’objet de groupe et d’application ne sont pas traduits, car ils n’ont pas de noms conviviaux uniques.

maxResults - Spécifie le nombre maximal d’objets blob à retourner par page, y compris tous les éléments BlobPrefix. Si la requête ne spécifie pas maxResults ou spécifie une valeur supérieure à 5 000, le serveur retourne jusqu’à 5 000 éléments par page. En cas d’itération par page, la taille de page passée aux méthodes byPage telles que PagedIterable#iterableByPage(int) sera préférée à cette valeur.

timeout - Valeur de délai d’expiration facultative au-delà de laquelle un RuntimeException sera déclenché.

Returns:

Liste des fichiers/répertoires.

rename

public DataLakeDirectoryClient rename(String destinationFileSystem, String destinationPath)

Déplace le répertoire vers un autre emplacement dans le système de fichiers. Pour plus d’informations, consultez Azure Docs.

Exemples de code

DataLakeDirectoryClient renamedClient = client.rename(fileSystemName, destinationPath);
 System.out.println("Directory Client has been renamed");

Parameters:

destinationFileSystem - Système de fichiers de la destination dans le compte. null pour le système de fichiers actuel.

destinationPath - Le chemin d’accès relatif du système de fichiers vers lequel renommer le répertoire exclut le nom du système de fichiers. Par exemple, si vous souhaitez déplacer un répertoire avec fileSystem = « myfilesystem », path = « mydir/mysubdir » vers un autre chemin dans myfilesystem (ex: newdir), définissez destinationPath = « newdir »

Returns:

DataLakeDirectoryClient utilisé pour interagir avec le nouveau répertoire créé.

renameWithResponse

public Response renameWithResponse(String destinationFileSystem, String destinationPath, DataLakeRequestConditions sourceRequestConditions, DataLakeRequestConditions destinationRequestConditions, Duration timeout, Context context)

Déplace le répertoire vers un autre emplacement dans le système de fichiers. Pour plus d’informations, consultez Azure Docs.

Exemples de code

DataLakeRequestConditions sourceRequestConditions = new DataLakeRequestConditions()
     .setLeaseId(leaseId);
 DataLakeRequestConditions destinationRequestConditions = new DataLakeRequestConditions();

 DataLakeDirectoryClient newRenamedClient = client.renameWithResponse(fileSystemName, destinationPath,
     sourceRequestConditions, destinationRequestConditions, timeout, new Context(key1, value1)).getValue();
 System.out.println("Directory Client has been renamed");

Parameters:

destinationFileSystem - Système de fichiers de la destination dans le compte. null pour le système de fichiers actuel.

destinationPath - Le chemin d’accès relatif du système de fichiers vers lequel renommer le répertoire exclut le nom du système de fichiers. Par exemple, si vous souhaitez déplacer un répertoire avec fileSystem = « myfilesystem », path = « mydir/mysubdir » vers un autre chemin dans myfilesystem (ex: newdir), définissez destinationPath = « newdir »

sourceRequestConditions - DataLakeRequestConditions par rapport à la source.

destinationRequestConditions - DataLakeRequestConditions par rapport à la destination.

timeout - Valeur de délai d’expiration facultative au-delà de laquelle un RuntimeException sera déclenché.

context - Contexte supplémentaire transmis via le pipeline Http pendant l’appel de service.

Returns:

Response<T> dont value qui contient un DataLakeDirectoryClient utilisé pour interagir avec le répertoire créé.