DataLakeDirectoryClient Klasse

Paket:

com.azure.storage.file.datalake

Maven-Artefakt:

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

Diese Klasse stellt einen Client bereit, der Verzeichnisvorgänge für Azure Storage Data Lake enthält. Zu den von diesem Client bereitgestellten Vorgängen gehören das Erstellen eines Verzeichnisses, das Löschen eines Verzeichnisses, das Umbenennen eines Verzeichnisses, das Festlegen von Metadaten und HTTP-Headern, das Festlegen und Abrufen der Zugriffssteuerung, das Abrufen von Eigenschaften sowie das Erstellen und Löschen von Dateien und Unterverzeichnissen.

Dieser Client wird über DataLakePathClientBuilder instanziiert oder über getDirectoryClient(String directoryName)abgerufen.

Weitere Informationen finden Sie in der Azure-Dokumentation .

Methodenzusammenfassung

Modifizierer und Typ	Methode und Beschreibung
DataLakeFileClient	createFile(String fileName) Erstellt eine neue Datei in einem Verzeichnis.
DataLakeFileClient	createFile(String fileName, boolean overwrite) Erstellt eine neue Datei in einem Verzeichnis.
DataLakeFileClient	createFileIfNotExists(String fileName) Erstellt eine neue Datei in einem Verzeichnis, falls sie nicht vorhanden ist.
Response<DataLakeFileClient>	createFileIfNotExistsWithResponse(String fileName, DataLakePathCreateOptions options, Duration timeout, Context context) Erstellt eine neue Datei in einem Verzeichnis, falls sie nicht vorhanden ist.
Response<DataLakeFileClient>	createFileWithResponse(String fileName, DataLakePathCreateOptions options, Duration timeout, Context context) Erstellt eine neue Datei in einem Verzeichnis.
Response<DataLakeFileClient>	createFileWithResponse(String fileName, String permissions, String umask, PathHttpHeaders headers, Map<String,String> metadata, DataLakeRequestConditions requestConditions, Duration timeout, Context context) Erstellt eine neue Datei in einem Verzeichnis.
DataLakeDirectoryClient	createSubdirectory(String subdirectoryName) Erstellt ein neues Unterverzeichnis innerhalb eines Verzeichnisses.
DataLakeDirectoryClient	createSubdirectory(String subdirectoryName, boolean overwrite) Erstellt ein neues Unterverzeichnis innerhalb eines Verzeichnisses.
DataLakeDirectoryClient	createSubdirectoryIfNotExists(String subdirectoryName) Erstellt ein neues Unterverzeichnis, wenn es nicht in einem Verzeichnis vorhanden ist.
Response<DataLakeDirectoryClient>	createSubdirectoryIfNotExistsWithResponse(String subdirectoryName, DataLakePathCreateOptions options, Duration timeout, Context context) Erstellt ein neues Unterverzeichnis innerhalb eines Verzeichnisses, sofern es nicht vorhanden ist.
Response<DataLakeDirectoryClient>	createSubdirectoryWithResponse(String subdirectoryName, DataLakePathCreateOptions options, Duration timeout, Context context) Erstellt ein neues Unterverzeichnis innerhalb eines Verzeichnisses.
Response<DataLakeDirectoryClient>	createSubdirectoryWithResponse(String subdirectoryName, String permissions, String umask, PathHttpHeaders headers, Map<String,String> metadata, DataLakeRequestConditions requestConditions, Duration timeout, Context context) Erstellt ein neues Unterverzeichnis innerhalb eines Verzeichnisses.
void	delete() Löscht ein Verzeichnis.
void	deleteFile(String fileName) Löscht die angegebene Datei im Verzeichnis.
boolean	deleteFileIfExists(String fileName) Löscht die angegebene Datei im Verzeichnis, sofern sie vorhanden ist.
Response<Boolean>	deleteFileIfExistsWithResponse(String fileName, DataLakePathDeleteOptions options, Duration timeout, Context context) Löscht die angegebene Datei im Verzeichnis, sofern sie vorhanden ist.
Response<Void>	deleteFileWithResponse(String fileName, DataLakeRequestConditions requestConditions, Duration timeout, Context context) Löscht die angegebene Datei im Verzeichnis.
boolean	deleteIfExists() Löscht ein Verzeichnis, sofern es vorhanden ist.
Response<Boolean>	deleteIfExistsWithResponse(DataLakePathDeleteOptions options, Duration timeout, Context context) Löscht ein Verzeichnis, sofern es vorhanden ist.
void	deleteRecursively() Löscht rekursiv ein Verzeichnis und alle Inhalte innerhalb des Verzeichnisses.
Response<Void>	deleteRecursivelyWithResponse(DataLakeRequestConditions requestConditions, Duration timeout, Context context) Löscht rekursiv ein Verzeichnis und alle Inhalte innerhalb des Verzeichnisses.
void	deleteSubdirectory(String subdirectoryName) Löscht das angegebene Unterverzeichnis im Verzeichnis.
boolean	deleteSubdirectoryIfExists(String subdirectoryName) Löscht das angegebene Unterverzeichnis im Verzeichnis, sofern es vorhanden ist.
Response<Boolean>	deleteSubdirectoryIfExistsWithResponse(String subdirectoryName, DataLakePathDeleteOptions options, Duration timeout, Context context) Löscht das angegebene Unterverzeichnis im Verzeichnis, sofern es vorhanden ist.
Response<Void>	deleteSubdirectoryWithResponse(String subdirectoryName, boolean recursive, DataLakeRequestConditions requestConditions, Duration timeout, Context context) Löscht das angegebene Unterverzeichnis im Verzeichnis.
Response<Void>	deleteWithResponse(boolean recursive, DataLakeRequestConditions requestConditions, Duration timeout, Context context) Löscht ein Verzeichnis.
DataLakeDirectoryClient	getCustomerProvidedKeyClient(CustomerProvidedKey customerProvidedKey) Erstellt einen neuen DataLakeDirectoryClient mit dem angegebenen customerProvidedKey.
String	getDirectoryName() Ruft den Namen dieses Verzeichnisses ab, ohne den vollständigen Pfad zu enthalten.
String	getDirectoryPath() Ruft den Pfad dieses Verzeichnisses ab, ohne den Namen der Ressource selbst.
String	getDirectoryUrl() Ruft die URL des Verzeichnisses ab, das von diesem Client im Data Lake-Dienst dargestellt wird.
DataLakeFileClient	getFileClient(String fileName) Initialisiert ein neues DataLakeFileClient-Objekt, indem der Dateinamemit dem Ende der URL des DataLakeDirectory-Clientsverkettet wird.
DataLakeDirectoryClient	getSubdirectoryClient(String subdirectoryName) Initialisiert ein neues DataLakeDirectoryClient-Objekt, indem der Verzeichnisnamemit dem Ende der URL des DataLakeDirectory-Clientsverkettet wird.
PagedIterable<PathItem>	listPaths() Gibt eine verzögert geladene Liste von Dateien/Verzeichnissen in diesem Verzeichnis zurück.
PagedIterable<PathItem>	listPaths(boolean recursive, boolean userPrincipleNameReturned, Integer maxResults, Duration timeout) Gibt eine verzögert geladene Liste von Dateien/Verzeichnissen in diesem Verzeichnis zurück.
DataLakeDirectoryClient	rename(String destinationFileSystem, String destinationPath) Verschiebt das Verzeichnis an einen anderen Speicherort im Dateisystem.
Response<DataLakeDirectoryClient>	renameWithResponse(String destinationFileSystem, String destinationPath, DataLakeRequestConditions sourceRequestConditions, DataLakeRequestConditions destinationRequestConditions, Duration timeout, Context context) Verschiebt das Verzeichnis an einen anderen Speicherort im Dateisystem.

Geerbte Methoden von 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

Geerbte Methoden von java.lang.Object

clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Details zur Methode

createFile

public DataLakeFileClient createFile(String fileName)

Erstellt eine neue Datei in einem Verzeichnis. Standardmäßig überschreibt diese Methode keine vorhandene Datei. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

DataLakeFileClient fileClient = client.createFile(fileName);

Parameters:

fileName - Name der Datei, die erstellt werden soll.

Returns:

Ein DataLakeFileClient , der für die Interaktion mit der erstellten Datei verwendet wird.

createFile

public DataLakeFileClient createFile(String fileName, boolean overwrite)

Erstellt eine neue Datei in einem Verzeichnis. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

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

Parameters:

fileName - Name der Datei, die erstellt werden soll.

overwrite - Ob überschrieben werden soll, sollte eine Datei vorhanden sein.

Returns:

Ein DataLakeFileClient , der für die Interaktion mit der erstellten Datei verwendet wird.

createFileIfNotExists

public DataLakeFileClient createFileIfNotExists(String fileName)

Erstellt eine neue Datei in einem Verzeichnis, wenn sie nicht vorhanden ist. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

DataLakeFileClient fileClient = client.createFileIfNotExists(fileName);

Parameters:

fileName - Name der Datei, die erstellt werden soll.

Returns:

Ein DataLakeFileClient , der verwendet wird, um mit der erstellten Datei zu interagieren.

createFileIfNotExistsWithResponse

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

Erstellt eine neue Datei in einem Verzeichnis, falls sie nicht vorhanden ist. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

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 - Name der Datei, die erstellt werden soll.

options - DataLakePathCreateOptions Metadatenschlüssel oder -wert muss entfernt oder codiert werden.

timeout - Ein optionaler Timeoutwert, über den ein RuntimeException ausgelöst wird.

context - Zusätzlicher Kontext, der während des Dienstaufrufs über die HTTP-Pipeline übergeben wird.

Returns:

Ein Response<T> , dessen value enthält den, der DataLakeFileAsyncClient verwendet wird, um mit der erstellten Datei zu interagieren. Wenn Response<T>status Code 201 ist, wurde erfolgreich eine neue Datei erstellt. Wenn status Code 409 ist, war an diesem Speicherort bereits eine Datei mit demselben Namen vorhanden.

createFileWithResponse

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

Erstellt eine neue Datei in einem Verzeichnis. Wenn bereits eine Datei mit demselben Namen vorhanden ist, wird die Datei überschrieben. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

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 - Name der Datei, die erstellt werden soll.

options - DataLakePathCreateOptions

timeout - Ein optionaler Timeoutwert, über den ein RuntimeException ausgelöst wird.

context - Zusätzlicher Kontext, der während des Dienstaufrufs über die HTTP-Pipeline übergeben wird.

Returns:

Ein Response<T> , dessen value enthält den, der DataLakeFileClient verwendet wird, um mit der erstellten Datei zu interagieren.

createFileWithResponse

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

Erstellt eine neue Datei in einem Verzeichnis. Wenn bereits eine Datei mit demselben Namen vorhanden ist, wird die Datei überschrieben. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

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 - Name der Datei, die erstellt werden soll.

permissions - POSIX-Zugriffsberechtigungen für den Dateibesitzer, die Dateibesitzergruppe und andere.

umask - Schränkt die Berechtigungen der zu erstellenden Datei ein.

headers - PathHttpHeaders

metadata - Metadaten, die der Datei zugeordnet werden sollen. Wenn in einem Metadatenschlüssel oder -wert führende oder nachfolgende Leerzeichen vorhanden sind, muss er entfernt oder codiert werden.

requestConditions - DataLakeRequestConditions

timeout - Ein optionaler Timeoutwert, über den ein RuntimeException ausgelöst wird.

context - Zusätzlicher Kontext, der während des Dienstaufrufs über die HTTP-Pipeline übergeben wird.

Returns:

Ein Response<T> , dessen value enthält den, der DataLakeFileClient verwendet wird, um mit der erstellten Datei zu interagieren.

createSubdirectory

public DataLakeDirectoryClient createSubdirectory(String subdirectoryName)

Erstellt ein neues Unterverzeichnis innerhalb eines Verzeichnisses. Standardmäßig überschreibt diese Methode kein vorhandenes Unterverzeichnis. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

DataLakeDirectoryClient directoryClient = client.createSubdirectory(directoryName);

Parameters:

subdirectoryName - Name des zu erstellenden Unterverzeichnisses.

Returns:

Ein DataLakeDirectoryClient , der für die Interaktion mit dem erstellten Unterverzeichnis verwendet wird.

createSubdirectory

public DataLakeDirectoryClient createSubdirectory(String subdirectoryName, boolean overwrite)

Erstellt ein neues Unterverzeichnis innerhalb eines Verzeichnisses. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

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

Parameters:

subdirectoryName - Name des zu erstellenden Unterverzeichnisses.

overwrite - Unabhängig davon, ob überschrieben werden soll, sollte das Unterverzeichnis vorhanden sein.

Returns:

Ein DataLakeDirectoryClient , der für die Interaktion mit dem erstellten Unterverzeichnis verwendet wird.

createSubdirectoryIfNotExists

public DataLakeDirectoryClient createSubdirectoryIfNotExists(String subdirectoryName)

Erstellt ein neues Unterverzeichnis, wenn es nicht in einem Verzeichnis vorhanden ist. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

DataLakeDirectoryClient directoryClient = client.createSubdirectoryIfNotExists(directoryName);

Parameters:

subdirectoryName - Name des zu erstellenden Unterverzeichnisses.

Returns:

Ein DataLakeDirectoryClient , der für die Interaktion mit dem erstellten Unterverzeichnis verwendet wird.

createSubdirectoryIfNotExistsWithResponse

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

Erstellt ein neues Unterverzeichnis innerhalb eines Verzeichnisses, sofern es nicht vorhanden ist. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

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 - Name des zu erstellenden Unterverzeichnisses.

options - DataLakePathCreateOptions

timeout - Ein optionaler Timeoutwert, über den ein RuntimeException ausgelöst wird.

context - Zusätzlicher Kontext, der während des Dienstaufrufs über die HTTP-Pipeline übergeben wird.

Returns:

Ein Response<T> , dessen value enthält den, der DataLakeDirectoryClient verwendet wird, um mit dem erstellten Unterverzeichnis zu interagieren. Wenn Response<T>status Code 201 ist, wurde erfolgreich ein neues Unterverzeichnis erstellt. Wenn status Code 409 ist, war an diesem Speicherort bereits ein Unterverzeichnis mit demselben Namen vorhanden.

createSubdirectoryWithResponse

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

Erstellt ein neues Unterverzeichnis innerhalb eines Verzeichnisses. Wenn bereits ein Unterverzeichnis mit demselben Namen vorhanden ist, wird das Unterverzeichnis überschrieben. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

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 - Name des zu erstellenden Unterverzeichnisses.

options - DataLakePathCreateOptions

timeout - Ein optionaler Timeoutwert, über den ein RuntimeException ausgelöst wird.

context - Zusätzlicher Kontext, der während des Dienstaufrufs über die HTTP-Pipeline übergeben wird.

Returns:

Ein Response<T> , dessen value eine DataLakeDirectoryClient enthält, die verwendet wird, um mit dem erstellten Unterverzeichnis zu interagieren.

createSubdirectoryWithResponse

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

Erstellt ein neues Unterverzeichnis innerhalb eines Verzeichnisses. Wenn bereits ein Unterverzeichnis mit demselben Namen vorhanden ist, wird das Unterverzeichnis überschrieben. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

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 - Name des zu erstellenden Unterverzeichnisses.

permissions - POSIX-Zugriffsberechtigungen für den Unterverzeichnisbesitzer, das Unterverzeichnis, das die Gruppe besitzt, und andere.

umask - Schränkt die Berechtigungen des zu erstellenden Unterverzeichnisses ein.

headers - PathHttpHeaders

metadata - Metadaten, die der Ressource zugeordnet werden sollen. Wenn in einem Metadatenschlüssel oder -wert führende oder nachfolgende Leerzeichen vorhanden sind, muss er entfernt oder codiert werden.

requestConditions - DataLakeRequestConditions

timeout - Ein optionaler Timeoutwert, über den ein RuntimeException ausgelöst wird.

context - Zusätzlicher Kontext, der während des Dienstaufrufs über die HTTP-Pipeline übergeben wird.

Returns:

Ein Response<T> , dessen value eine DataLakeDirectoryClient enthält, die verwendet wird, um mit dem erstellten Unterverzeichnis zu interagieren.

delete

public void delete()

Löscht ein Verzeichnis.

Codebeispiele

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

Weitere Informationen finden Sie in der Azure-Dokumentation.

deleteFile

public void deleteFile(String fileName)

Löscht die angegebene Datei im Verzeichnis. Wenn die Datei nicht vorhanden ist, schlägt der Vorgang fehl. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

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

Parameters:

fileName - Name der zu löschenden Datei.

deleteFileIfExists

public boolean deleteFileIfExists(String fileName)

Löscht die angegebene Datei im Verzeichnis, sofern sie vorhanden ist. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

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

Parameters:

fileName - Name der zu löschenden Datei.

Returns:

true , wenn die Datei erfolgreich gelöscht wurde, false wenn die Datei nicht vorhanden ist.

deleteFileIfExistsWithResponse

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

Löscht die angegebene Datei im Verzeichnis, sofern sie vorhanden ist. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

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 - Name der zu löschenden Datei.

options - DataLakePathDeleteOptions

timeout - Ein optionaler Timeoutwert, über den ein RuntimeException ausgelöst wird.

context - Zusätzlicher Kontext, der während des Dienstaufrufs über die HTTP-Pipeline übergeben wird.

Returns:

Eine Antwort, die status Code und HTTP-Header enthält. Wenn Response<T>status Code 200 ist, wurde die angegebene Datei erfolgreich gelöscht. Wenn status Code 404 ist, ist die angegebene Datei nicht vorhanden.

deleteFileWithResponse

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

Löscht die angegebene Datei im Verzeichnis. Wenn die Datei nicht vorhanden ist, schlägt der Vorgang fehl. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

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

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

Parameters:

fileName - Name der zu löschenden Datei.

requestConditions - DataLakeRequestConditions

timeout - Ein optionaler Timeoutwert, über den ein RuntimeException ausgelöst wird.

context - Zusätzlicher Kontext, der während des Dienstaufrufs über die HTTP-Pipeline übergeben wird.

Returns:

Eine Antwort mit status Code und HTTP-Headern

deleteIfExists

public boolean deleteIfExists()

Löscht ein Verzeichnis, sofern es vorhanden ist.

Codebeispiele

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

Weitere Informationen finden Sie in der Azure-Dokumentation.

Overrides:

DataLakeDirectoryClient.deleteIfExists()

Returns:

true , wenn das Verzeichnis erfolgreich gelöscht wurde, false wenn das Verzeichnis nicht vorhanden ist.

deleteIfExistsWithResponse

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

Löscht ein Verzeichnis, sofern es vorhanden ist.

Codebeispiele

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());
 }

Weitere Informationen finden Sie in der Azure-Dokumentation.

Overrides:

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

Parameters:

options - DataLakePathDeleteOptions

timeout - Ein optionaler Timeoutwert, über den ein RuntimeException ausgelöst wird.

context - Zusätzlicher Kontext, der während des Dienstaufrufs über die HTTP-Pipeline übergeben wird.

Returns:

Eine Antwort, die status Code und HTTP-Header enthält. Wenn Response<T>status Code 200 ist, wurde das Verzeichnis erfolgreich gelöscht. Wenn status Code 404 ist, ist das Verzeichnis nicht vorhanden.

deleteRecursively

public void deleteRecursively()

Löscht rekursiv ein Verzeichnis und alle Inhalte innerhalb des Verzeichnisses.

Codebeispiele

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

Weitere Informationen finden Sie in der Azure-Dokumentation.

deleteRecursivelyWithResponse

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

Löscht rekursiv ein Verzeichnis und alle Inhalte innerhalb des Verzeichnisses.

Codebeispiele

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

Weitere Informationen finden Sie in der Azure-Dokumentation.

Parameters:

requestConditions - DataLakeRequestConditions

timeout - Ein optionaler Timeoutwert, über den ein RuntimeException ausgelöst wird.

context - Zusätzlicher Kontext, der während des Dienstaufrufs über die HTTP-Pipeline übergeben wird.

Returns:

Abschluss einer reaktiven Antwortsignalisierung.

deleteSubdirectory

public void deleteSubdirectory(String subdirectoryName)

Löscht das angegebene Unterverzeichnis im Verzeichnis. Wenn das Unterverzeichnis nicht vorhanden ist oder nicht leer ist, schlägt der Vorgang fehl. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

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

Parameters:

subdirectoryName - Name des zu löschenden Unterverzeichnisses.

deleteSubdirectoryIfExists

public boolean deleteSubdirectoryIfExists(String subdirectoryName)

Löscht das angegebene Unterverzeichnis im Verzeichnis, sofern es vorhanden ist. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

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

Parameters:

subdirectoryName - Name des zu löschenden Unterverzeichnisses.

Returns:

true , wenn das Unterverzeichnis erfolgreich gelöscht wurde, false wenn das Unterverzeichnis nicht vorhanden ist.

deleteSubdirectoryIfExistsWithResponse

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

Löscht das angegebene Unterverzeichnis im Verzeichnis, sofern es vorhanden ist. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

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 - Name des zu löschenden Unterverzeichnisses.

options - DataLakePathDeleteOptions

timeout - Ein optionaler Timeoutwert, über den ein RuntimeException ausgelöst wird.

context - Zusätzlicher Kontext, der während des Dienstaufrufs über die HTTP-Pipeline übergeben wird.

Returns:

Eine Antwort, die status Code und HTTP-Header enthält. Wenn Response<T>status Code 200 ist, wurde das angegebene Unterverzeichnis erfolgreich gelöscht. Wenn status Code 404 ist, ist das angegebene Unterverzeichnis nicht vorhanden.

deleteSubdirectoryWithResponse

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

Löscht das angegebene Unterverzeichnis im Verzeichnis. Wenn das Unterverzeichnis nicht vorhanden ist oder nicht leer ist, schlägt der Vorgang fehl. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

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 - Name des zu löschenden Unterverzeichnisses.

recursive - Gibt an, ob alle Pfade unter dem Unterverzeichnis gelöscht werden sollen oder nicht.

requestConditions - DataLakeRequestConditions

timeout - Ein optionaler Timeoutwert, über den ein RuntimeException ausgelöst wird.

context - Zusätzlicher Kontext, der während des Dienstaufrufs über die HTTP-Pipeline übergeben wird.

Returns:

Eine Antwort mit status Code und HTTP-Headern

deleteWithResponse

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

Löscht ein Verzeichnis.

Codebeispiele

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");

Weitere Informationen finden Sie in der Azure-Dokumentation.

Parameters:

recursive - Gibt an, ob alle Pfade unter dem Verzeichnis gelöscht werden sollen oder nicht.

requestConditions - DataLakeRequestConditions

timeout - Ein optionaler Timeoutwert, über den ein RuntimeException ausgelöst wird.

context - Zusätzlicher Kontext, der während des Dienstaufrufs über die HTTP-Pipeline übergeben wird.

Returns:

Abschluss einer reaktiven Antwortsignalisierung.

getCustomerProvidedKeyClient

public DataLakeDirectoryClient getCustomerProvidedKeyClient(CustomerProvidedKey customerProvidedKey)

Erstellt einen neuen DataLakeDirectoryClient mit dem angegebenen customerProvidedKey.

Overrides:

DataLakeDirectoryClient.getCustomerProvidedKeyClient(CustomerProvidedKey customerProvidedKey)

Parameters:

customerProvidedKey - für CustomerProvidedKey das Verzeichnis übergeben null , um keinen vom Kunden bereitgestellten Schlüssel zu verwenden.

Returns:

a DataLakeDirectoryClient mit dem angegebenen customerProvidedKey.

getDirectoryName

public String getDirectoryName()

Ruft den Namen dieses Verzeichnisses ab, ohne den vollständigen Pfad zu enthalten.

Returns:

Der Name des Verzeichnisses.

getDirectoryPath

public String getDirectoryPath()

Ruft den Pfad dieses Verzeichnisses ab, ohne den Namen der Ressource selbst.

Returns:

Der Pfad des Verzeichnisses.

getDirectoryUrl

public String getDirectoryUrl()

Ruft die URL des Verzeichnisses ab, das von diesem Client im Data Lake-Dienst dargestellt wird.

Returns:

die URL.

getFileClient

public DataLakeFileClient getFileClient(String fileName)

Initialisiert ein neues DataLakeFileClient-Objekt, indem fileName am Ende der DataLakeDirectoryClient-URL verkettet wird. Der neue DataLakeFileClient verwendet dieselbe Anforderungsrichtlinienpipeline wie dataLakeDirectoryClient.

Parameters:

fileName - Ein String , der den Namen der Datei darstellt. Codebeispiele

 DataLakeFileClient dataLakeFileClient = client.getFileClient(fileName);
 

Returns:

Ein neues DataLakeFileClient Objekt, das auf die Datei mit dem angegebenen Namen in diesem Verzeichnis verweist.

getSubdirectoryClient

public DataLakeDirectoryClient getSubdirectoryClient(String subdirectoryName)

Initialisiert ein neues DataLakeDirectoryClient-Objekt, indem directoryName mit dem Ende der DataLakeDirectoryClient-URL verkettet wird. Der neue DataLakeDirectoryClient verwendet dieselbe Anforderungsrichtlinienpipeline wie dataLakeDirectoryClient.

Parameters:

subdirectoryName - Ein String , der den Namen des Unterverzeichnisses darstellt. Codebeispiele

 DataLakeDirectoryClient dataLakeDirectoryClient = client.getSubdirectoryClient(directoryName);
 

Returns:

Ein neues DataLakeDirectoryClient Objekt, das auf das Unterverzeichnis mit dem angegebenen Namen in diesem Verzeichnis verweist.

listPaths

public PagedIterable listPaths()

Gibt eine verzögert geladene Liste von Dateien/Verzeichnissen in diesem Verzeichnis zurück. Das zurückgegebene PagedIterable<T> kann verwendet werden, während neue Elemente bei Bedarf automatisch abgerufen werden. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

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

Returns:

Die Liste der Dateien/Verzeichnisse.

listPaths

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

Gibt eine verzögert geladene Liste von Dateien/Verzeichnissen in diesem Verzeichnis zurück. Das zurückgegebene PagedIterable<T> kann verwendet werden, während neue Elemente bei Bedarf automatisch abgerufen werden. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

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

Parameters:

recursive - Gibt an, ob der Aufruf rekursiv alle Pfade enthalten soll.

userPrincipleNameReturned - Bei "true" werden die in den Antwortheadern x-ms-owner, x-ms-group und x-ms-acl zurückgegebenen Benutzeridentitätswerte von Azure Active Directory-Objekt-IDs in Benutzerprinzipalnamen transformiert. Bei "false" werden die Werte als Azure Active Directory-Objekt-IDs zurückgegeben. Der Standardwert ist „FALSE“. Beachten Sie, dass Gruppen- und Anwendungsobjekt-IDs nicht übersetzt werden, da sie keine eindeutigen Anzeigenamen haben.

maxResults - Gibt die maximale Anzahl von Blobs an, die pro Seite zurückgegeben werden sollen, einschließlich aller BlobPrefix-Elemente. Wenn die Anforderung maxResults nicht angibt oder einen Wert größer als 5.000 angibt, gibt der Server bis zu 5.000 Elemente pro Seite zurück. Beim Durchlaufen nach Seite wird die seitengröße, die an byPage-Methoden wie übergeben wird, gegenüber PagedIterable#iterableByPage(int) diesem Wert bevorzugt.

timeout - Ein optionaler Timeoutwert, ab dem ein RuntimeException ausgelöst wird.

Returns:

Die Liste der Dateien/Verzeichnisse.

rename

public DataLakeDirectoryClient rename(String destinationFileSystem, String destinationPath)

Verschiebt das Verzeichnis an einen anderen Speicherort im Dateisystem. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

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

Parameters:

destinationFileSystem - Das Dateisystem des Ziels innerhalb des Kontos. null für das aktuelle Dateisystem.

destinationPath - Der relative Pfad aus dem Dateisystem, in den das Verzeichnis umbenannt werden soll, schließt den Dateisystemnamen aus. Wenn Sie beispielsweise ein Verzeichnis mit fileSystem = "myfilesystem", path = "mydir/mysubdir" in einen anderen Pfad in myfilesystem (z. B. newdir) verschieben möchten, legen Sie dann den destinationPath = "newdir" fest.

Returns:

Ein DataLakeDirectoryClient , der für die Interaktion mit dem neu erstellten Verzeichnis verwendet wird.

renameWithResponse

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

Verschiebt das Verzeichnis an einen anderen Speicherort im Dateisystem. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

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 - Das Dateisystem des Ziels innerhalb des Kontos. null für das aktuelle Dateisystem.

destinationPath - Der relative Pfad aus dem Dateisystem, in den das Verzeichnis umbenannt werden soll, schließt den Dateisystemnamen aus. Wenn Sie beispielsweise ein Verzeichnis mit fileSystem = "myfilesystem", path = "mydir/mysubdir" in einen anderen Pfad in myfilesystem (z. B. newdir) verschieben möchten, legen Sie dann den destinationPath = "newdir" fest.

sourceRequestConditions - DataLakeRequestConditions für die Quelle.

destinationRequestConditions - DataLakeRequestConditions für das Ziel.

timeout - Ein optionaler Timeoutwert, ab dem ein RuntimeException ausgelöst wird.

context - Zusätzlicher Kontext, der während des Dienstaufrufs über die HTTP-Pipeline übergeben wird.

Returns:

Eine Response<T> , der eine value enthält DataLakeDirectoryClient , die für die Interaktion mit dem erstellten Verzeichnis verwendet wird.