Dateimetadaten mit Cloud Storage für C++ verwenden

Nachdem Sie eine Datei in die Referenz Cloud Storage hochgeladen haben, können Sie auch die Dateimetadaten abrufen und aktualisieren, z. B. um den Inhaltstyp zu aktualisieren. In Dateien können auch benutzerdefinierte Schlüssel/Wert-Paare mit zusätzlichen Dateimetadaten gespeichert werden.

Dateimetadaten abrufen

Dateimetadaten enthalten gängige Attribute wie name, size und content_type (oft als MIME-Typ bezeichnet) sowie einige weniger gängige Attribute 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. Eine vollständige Liste der aktualisierbaren Attribute finden Sie in der vollständigen Liste. Nur die in den Metadaten angegebenen Attribute werden 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 Metadatenattribute löschen, indem Sie einen 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 verarbeiten

Es gibt eine Reihe von Gründen, warum beim Abrufen oder Aktualisieren von Metadaten Fehler auftreten können, z. B. weil die Datei nicht vorhanden ist oder der Nutzer keine Berechtigung für den 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-Attributen 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 anwendungsspezifische Daten für jede Datei in benutzerdefinierten Metadaten speichern. Wir empfehlen jedoch dringend, eine Datenbank (z. B. die Firebase Realtime Database) zu verwenden, um diese Art von Daten zu speichern und zu synchronisieren.

Dateimetadaten-Eigenschaften

Eine vollständige Liste der Metadaten-Properties für eine Datei finden Sie unten:

Attribut	Typ	Bearbeitbar
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, aber auch das Entfernen von Dateien. Dateien aus Cloud Storage löschen