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. 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
content_type
(oft als MIME-Typ bezeichnet) zusätzlich zu einigen weniger gängigen
wie content_disposition
und time_created
. 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 StorageReference forest_ref = storage_ref.Child("images/forest.jpg"); // Get metadata properties Futurefuture = forest_ref.GetMetadata(); // Wait for Future to complete... if (future.Error() != firebase::storage::kErrorNone) { // Uh-oh, an error occurred! } else { // We can now retrieve the metadata for 'images/forest.jpg' Metadata* metadata = future.Result(); }
Dateimetadaten aktualisieren
Sie können die Dateimetadaten jederzeit nach Abschluss des Dateiuploads aktualisieren, indem Sie
mit der Methode UpdateMetadata
. Weitere Informationen finden Sie in der
finden Sie in der vollständigen Liste.
aktualisiert werden kann. 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 firebase::storage::StorageReference forest_ref = storage_ref.child("images/forest.jpg"); // Create file metadata to update Metadata new_metadata; newMetadata.set_cache_control("public,max-age=300"); newMetadata.set_content_type("image/jpeg"); // Update metadata properties Futurefuture = forest_ref.UpdateMetadata(new_metadata); // Wait for Future to complete... if (future.Error() != firebase::storage::kErrorNone) { // Uh-oh, an error occurred! } else { // We can now retrieve the updated metadata for 'images/forest.jpg' Metadata* metadata = future.Result(); }
Sie können beschreibbare Metadateneigenschaften löschen, indem Sie den leeren String übergeben:
// Create file metadata with property to delete StorageMetadata new_metadata; new_metadata.set_content_type(""); // Delete the metadata property Futurefuture = forest_ref.UpdateMetadata(new_metadata); // Wait for Future to complete... if (future.Error() != 0) { // Uh-oh, an error occurred! } else { // metadata.content_type() should be an empty string Metadata* metadata = future.Result(); }
Fehler behandeln
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 std::map
angeben, die std::string
enthalten.
Eigenschaften.
std::map<std::string, std::string>* custom_metadata = metadata.custom_metadata(); custom_metadata->insert(std::make_pair("location", "Yosemite, CA, USA"); custom_metadata->insert(std::make_pair("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.
Dateimetadateneigenschaften
Eine vollständige Liste der Metadateneigenschaften einer Datei finden Sie unten:
Attribut | Typ | Beschreibbar |
---|---|---|
bucket |
const char* | NEIN |
generation |
const char* | NEIN |
metageneration |
const char* | NEIN |
full_path |
const char* | NEIN |
name |
const char* | NEIN |
size |
int64_t | NEIN |
time_created |
int64_t | NEIN |
updated |
int64_t | NEIN |
cache_control |
const char* | YES |
content_disposition |
const char* | YES |
content_encoding |
const char* | YES |
content_language |
const char* | YES |
content_type |
const char* | YES |
download_urls |
std::vector<std::string> | NEIN |
custom_metadata |
std::map<std::string, std::string> | YES |
Nächste Schritte
Das Hochladen, Herunterladen und Aktualisieren von Dateien ist wichtig, um sie zu entfernen. Sehen wir uns an, wie Sie Dateien in Cloud Storage löschen.