Nachdem Sie eine Datei in Cloud Storage hochgeladen haben, können Sie auch die Metadaten der Datei abrufen und aktualisieren, z. B. um den Inhaltstyp anzusehen oder zu aktualisieren. In Dateien können auch benutzerdefinierte Schlüssel/Wert-Paare mit zusätzlichen Dateimetadaten gespeichert werden.
Dateimetadaten abrufen
Dateimetadaten enthalten allgemeine Attribute wie name
, size
und contentType
(oft als MIME-Typ bezeichnet) sowie einige weniger häufige Attribute 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 Metadaten einer Datei jederzeit nach Abschluss des Dateiuploads mit der Methode updateMetadata()
aktualisieren. Hier finden Sie eine vollständige Liste der Attribute, die aktualisiert werden können. Es werden nur die in den Metadaten angegebenen Attribute 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 beheben
Es gibt eine Reihe von Gründen, warum beim Abrufen oder Aktualisieren von Metadaten Fehler auftreten können. Dazu gehören, dass die Datei nicht vorhanden ist oder der Nutzer keine Berechtigung hat, auf die gewünschte Datei zuzugreifen. Weitere Informationen zu Fehlern finden Sie in der Dokumentation im Abschnitt Fehlerbehandlung.
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 app-spezifische Daten für jede Datei in benutzerdefinierten Metadaten speichern. Wir empfehlen jedoch dringend, eine Datenbank (z. B. die Firebase Realtime Database) zum Speichern und Synchronisieren dieser Art von Daten zu verwenden.
Eigenschaften von Dateimetadaten
Eine vollständige Liste der Metadatenattribute für eine Datei finden Sie unten:
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. Dateien aus Cloud Storage löschen