Nachdem Sie eine Datei in Cloud Storage hochgeladen haben, können Sie auch die Dateimetadaten abrufen und aktualisieren, z. B. um den Inhaltstyp aufzurufen oder zu aktualisieren. In Dateien können auch benutzerdefinierte Schlüssel/Wert-Paare mit zusätzlichen Dateimetadaten gespeichert werden.
Dateimetadaten abrufen
Dateimetadaten enthalten gängige Eigenschaften wie name, size und contentType (oft als MIME-Typ bezeichnet) sowie einige weniger gängige wie contentDisposition und timeCreated. Diese Metadaten können mit der Methode getMetadata() aus einer Cloud Storage-Referenz abgerufen werden.
// Create reference to the file whose metadata we want to retrieve
final forestRef = storageRef.child("images/forest.jpg");
// Get metadata properties
final metadata = await forestRef.getMetadata();
// Metadata now contains the metadata for 'images/forest.jpg'
Dateimetadaten aktualisieren
Sie können die Dateimetadaten jederzeit nach Abschluss des Dateiuploads mit der Methode updateMetadata() aktualisieren. Weitere Informationen zu den Attributen, die Sie aktualisieren können, finden Sie in der vollständigen Liste. Es werden nur die in den Metadaten angegebenen Properties aktualisiert. Alle anderen bleiben unverändert.
// Create reference to the file whose metadata we want to change
final forestRef = storageRef.child("images/forest.jpg");
// Create file metadata to update
final newMetadata = SettableMetadata(
cacheControl: "public,max-age=300",
contentType: "image/jpeg",
);
// Update metadata properties
final metadata = await forestRef.updateMetadata(newMetadata);
// Updated metadata for 'images/forest.jpg' is returned
Sie können beschreibbare Metadateneigenschaften löschen, indem Sie null übergeben:
// Delete the cacheControl property
final newMetadata = SettableMetadata(cacheControl: null);
final metadata = await forestRef.updateMetadata(newMetadata);
Fehler behandeln
Es kann verschiedene Gründe dafür geben, dass beim Abrufen oder Aktualisieren von Metadaten Fehler auftreten. Dazu gehört beispielsweise, dass die Datei nicht vorhanden ist oder der Nutzer keine Berechtigung zum Zugriff auf die gewünschte Datei hat. Weitere Informationen zu Fehlern finden Sie im Abschnitt Fehler beheben der Dokumentation.
Benutzerdefinierte Metadaten
Sie können benutzerdefinierte Metadaten mit dem Parameter customMetadata des Konstruktors SettableMetadata angeben:
// Create reference to the file whose metadata we want to change
final forestRef = storageRef.child("images/forest.jpg");
// Create file metadata to update
final newCustomMetadata = SettableMetadata(
customMetadata: {
"location": "Yosemite, CA, USA",
"activity": "Hiking",
},
);
// Update metadata properties
final metadata = await forestRef.updateMetadata(newCustomMetadata);
// Updated metadata for 'images/forest.jpg' is returned
Sie können appspezifische Daten für jede Datei in benutzerdefinierten Metadaten speichern. Wir empfehlen jedoch dringend, eine Datenbank wie die Firebase Realtime Database zum Speichern und Synchronisieren dieser Art von Daten zu verwenden.
Dateimetadateneigenschaften
Unten findest du eine vollständige Liste der Metadateneigenschaften in einer Datei:
| Attribut | Typ | Einstellbar? |
|---|---|---|
bucket |
String |
Nein |
generation |
String |
Nein |
metageneration |
String |
Nein |
metadataGeneration |
String |
Nein |
fullPath |
String |
Nein |
name |
String |
Nein |
size |
int |
Nein |
timeCreated |
DateTime |
Nein |
updated |
DateTime |
Nein |
md5Hash |
String |
Nein |
cacheControl |
String |
Ja |
contentDisposition |
String |
Ja |
contentEncoding |
String |
Ja |
contentLanguage |
String |
Ja |
contentType |
String |
Ja |
customMetadata |
Map<String, String> |
Ja |
Das Hochladen, Herunterladen und Aktualisieren von Dateien ist wichtig, aber auch das Entfernen von Dateien. Sehen wir uns an, wie Sie Dateien aus Cloud Storage löschen.