Dateimetadaten mit Cloud Storage für C++ verwenden

Nachdem du eine Datei in Cloud Storage hochgeladen hast, kannst du auch die Dateimetadaten abrufen und aktualisieren, z. B. den Inhaltstyp. 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 content_type (häufig als MIME-Typ bezeichnet) sowie einige weniger gängige 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
Future future = 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 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
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
Future future = 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 Metadaten-Properties 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
Future future = 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 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 als std::map mit std::string-Eigenschaften angeben.

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

Sie können appspezifische Daten für jede Datei in benutzerdefinierten Metadaten speichern. Wir empfehlen jedoch dringend, eine Datenbank wie Firebase Realtime Database zu verwenden, um diese Art von Daten zu speichern und zu synchronisieren.

Eigenschaften von Dateimetadaten

Eine vollständige Liste der Metadateneigenschaften einer Datei finden Sie unten:

Nächste Schritte

Das Hochladen, Herunterladen und Aktualisieren von Dateien ist wichtig, aber auch die Möglichkeit, sie zu entfernen. Sehen wir uns an, wie Sie Dateien in Cloud Storage löschen.