Nach dem Hochladen einer Datei in eine Cloud Storage-Referenz kannst du auch Folgendes abrufen: und die Metadaten der Datei aktualisieren, um z. B. den Inhaltstyp zu aktualisieren. Dateien können auch benutzerdefinierte Schlüssel/Wert-Paare mit zusätzlichen Dateimetadaten speichern.
Dateimetadaten abrufen
Dateimetadaten enthalten allgemeine Attribute wie name
, size
und
contentType
(oft als MIME-Typ bezeichnet) zusätzlich zu einigen
häufig vorkommende wie contentDisposition
und timeCreated
. Diese Metadaten können
aus einer Cloud Storage-Referenz mithilfe von
die Methode metadataWithCompletion:
.
Swift
// Create reference to the file whose metadata we want to retrieve let forestRef = storageRef.child("images/forest.jpg") // Get metadata properties do { let metadata = try await forestRef.getMetadata() } catch { // ... }
Objective-C
// Create reference to the file whose metadata we want to retrieve FIRStorageReference *forestRef = [storageRef child:@"images/forest.jpg"]; // Get metadata properties [forestRef metadataWithCompletion:^(FIRStorageMetadata *metadata, NSError *error) { if (error != nil) { // Uh-oh, an error occurred! } else { // Metadata now contains the metadata for 'images/forest.jpg' } }];
Dateimetadaten aktualisieren
Sie können die Dateimetadaten jederzeit nach Abschluss des Dateiuploads aktualisieren, indem Sie
mit der Methode updateMetadata:withCompletion:
. Weitere Informationen finden Sie in der
finden Sie in der vollständigen Liste.
aktualisiert werden kann. Es werden nur die in den
Metadaten angegebenen Eigenschaften aktualisiert.
alle anderen bleiben unverändert.
Swift
// Create reference to the file whose metadata we want to change let forestRef = storageRef.child("images/forest.jpg") // Create file metadata to update let newMetadata = StorageMetadata() newMetadata.cacheControl = "public,max-age=300" newMetadata.contentType = "image/jpeg" // Update metadata properties do { let updatedMetadata = try await forestRef.updateMetadata(newMetadata) } catch { // ... }
Objective-C
// Create reference to the file whose metadata we want to change FIRStorageReference *forestRef = [storageRef child:@"images/forest.jpg"]; // Create file metadata to update FIRStorageMetadata *newMetadata = [[FIRStorageMetadata alloc] init]; newMetadata.cacheControl = @"public,max-age=300"; newMetadata.contentType = @"image/jpeg"; // Update metadata properties [forestRef updateMetadata:newMetadata completion:^(FIRStorageMetadata *metadata, NSError *error){ if (error != nil) { // Uh-oh, an error occurred! } else { // Updated metadata for 'images/forest.jpg' is returned } }];
Sie können beschreibbare Metadateneigenschaften löschen, indem Sie sie auf nil
setzen:
Objective-C
FIRStorageMetadata *newMetadata = [[FIRStorageMetadata alloc] init]; newMetadata.contentType = nil; // Delete the metadata property [forestRef updateMetadata:newMetadata completion:^(FIRStorageMetadata *metadata, NSError *error){ if (error != nil) { // Uh-oh, an error occurred! } else { // metadata.contentType should be nil } }];
Swift
let newMetadata = StorageMetadata() newMetadata.contentType = nil do { // Delete the metadata property let updatedMetadata = try await forestRef.updateMetadata(newMetadata) } catch { // ... }
Fehler beheben
Es gibt eine Reihe von Gründen, warum beim Abrufen oder Aktualisieren Metadaten, einschließlich der Datei, die nicht vorhanden ist, oder des Nutzers ohne Berechtigung um auf die gewünschte Datei zuzugreifen. Weitere Informationen zu Fehlern finden Sie in der Fehler beheben der Dokumentation.
Benutzerdefinierte Metadaten
Sie können benutzerdefinierte Metadaten als NSDictionary
angeben, die NSString
enthalten.
Eigenschaften.
Swift
let metadata = [ "customMetadata": [ "location": "Yosemite, CA, USA", "activity": "Hiking" ] ]
Objective-C
NSDictionary *metadata = @{ @"customMetadata": @{ @"location": @"Yosemite, CA, USA", @"activity": @"Hiking" } };
App-spezifische Daten für jede Datei lassen sich in benutzerdefinierten Metadaten speichern. empfehlen wir die Verwendung einer Datenbank (z. B. der Firebase Realtime Database), um diese Art von Daten.
Eigenschaften von Dateimetadaten
Eine vollständige Liste der Metadateneigenschaften einer Datei finden Sie unten:
Attribut | Typ | Beschreibbar |
---|---|---|
bucket |
String | Nein |
generation |
String | Nein |
metageneration |
String | Nein |
fullPath |
String | Nein |
name |
String | Nein |
size |
INT64 | Nein |
timeCreated |
Datum | Nein |
updated |
Datum | Nein |
md5Hash |
String | Ja |
cacheControl |
String | Ja |
contentDisposition |
String | Ja |
contentEncoding |
String | Ja |
contentLanguage |
String | Ja |
contentType |
String | Ja |
customMetadata |
[String: String] | Ja |
Das Hochladen, Herunterladen und Aktualisieren von Dateien ist wichtig, um sie zu entfernen. Sehen wir uns an, wie Sie Dateien löschen von Cloud Storage.