Nachdem Sie eine Datei in die Cloud Storage-Referenz 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 allgemeine Attribute wie name
, size
und
contentType
(oft als MIME-Typ bezeichnet) zusätzlich zu einigen
häufig vorkommende wie contentDisposition
und timeCreated
. Diese Metadaten können mit der Methode getMetadata()
aus einer Cloud Storage-Referenz abgerufen werden.
Kotlin+KTX
// Create a storage reference from our app val storageRef = storage.reference // Get reference to the file val forestRef = storageRef.child("images/forest.jpg")
forestRef.metadata.addOnSuccessListener { metadata -> // Metadata now contains the metadata for 'images/forest.jpg' }.addOnFailureListener { // Uh-oh, an error occurred! }
Java
// Create a storage reference from our app StorageReference storageRef = storage.getReference(); // Get reference to the file StorageReference forestRef = storageRef.child("images/forest.jpg");
forestRef.getMetadata().addOnSuccessListener(new OnSuccessListener<StorageMetadata>() { @Override public void onSuccess(StorageMetadata storageMetadata) { // Metadata now contains the metadata for 'images/forest.jpg' } }).addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception exception) { // Uh-oh, an error occurred! } });
Dateimetadaten aktualisieren
Sie können die Dateimetadaten jederzeit nach Abschluss des Dateiuploads mit der Methode updateMetadata()
aktualisieren. Weitere Informationen finden Sie im
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.
Kotlin+KTX
// Create a storage reference from our app val storageRef = storage.reference // Get reference to the file val forestRef = storageRef.child("images/forest.jpg")
// Create file metadata including the content type val metadata = storageMetadata { contentType = "image/jpg" setCustomMetadata("myCustomProperty", "myValue") } // Update metadata properties forestRef.updateMetadata(metadata).addOnSuccessListener { updatedMetadata -> // Updated metadata is in updatedMetadata }.addOnFailureListener { // Uh-oh, an error occurred! }
Java
// Create a storage reference from our app StorageReference storageRef = storage.getReference(); // Get reference to the file StorageReference forestRef = storageRef.child("images/forest.jpg");
// Create file metadata including the content type StorageMetadata metadata = new StorageMetadata.Builder() .setContentType("image/jpg") .setCustomMetadata("myCustomProperty", "myValue") .build(); // Update metadata properties forestRef.updateMetadata(metadata) .addOnSuccessListener(new OnSuccessListener<StorageMetadata>() { @Override public void onSuccess(StorageMetadata storageMetadata) { // Updated metadata is in storageMetadata } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception exception) { // Uh-oh, an error occurred! } });
Sie können beschreibbare Metadateneigenschaften löschen, indem Sie null
übergeben:
Kotlin+KTX
// Create file metadata with property to delete val metadata = storageMetadata { contentType = null } // Delete the metadata property forestRef.updateMetadata(metadata).addOnSuccessListener { updatedMetadata -> // updatedMetadata.contentType should be null }.addOnFailureListener { // Uh-oh, an error occurred! }
Java
// Create file metadata with property to delete StorageMetadata metadata = new StorageMetadata.Builder() .setContentType(null) .build(); // Delete the metadata property forestRef.updateMetadata(metadata) .addOnSuccessListener(new OnSuccessListener<StorageMetadata>() { @Override public void onSuccess(StorageMetadata storageMetadata) { // metadata.contentType should be null } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception exception) { // Uh-oh, an error occurred! } });
Fehler beheben
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
Mit der Methode setCustomMetadata()
können Sie benutzerdefinierte Metadaten in der
Klasse StorageMetadata.Builder
.
Kotlin+KTX
val metadata = storageMetadata { setCustomMetadata("location", "Yosemite, CA, USA") setCustomMetadata("activity", "Hiking") }
Java
StorageMetadata metadata = new StorageMetadata.Builder() .setCustomMetadata("location", "Yosemite, CA, USA") .setCustomMetadata("activity", "Hiking") .build();
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 zu speichern und zu synchronisieren.
Eigenschaften von Dateimetadaten
Eine vollständige Liste der Metadateneigenschaften einer Datei finden Sie unten:
Property Getter | Typ | Setter ist vorhanden |
---|---|---|
getBucket |
String |
NEIN |
getGeneration |
String |
NEIN |
getMetadataGeneration |
String |
NEIN |
getPath |
String |
NEIN |
getName |
String |
NEIN |
getSizeBytes |
long |
NEIN |
getCreationTimeMillis |
long |
NEIN |
getUpdatedTimeMillis |
long |
NEIN |
getMd5Hash |
String |
NEIN |
getCacheControl |
String |
YES |
getContentDisposition |
String |
YES |
getContentEncoding |
String |
YES |
getContentLanguage |
String |
YES |
getContentType |
String |
YES |
getCustomMetadata |
String |
YES |
getCustomMetadataKeys |
Set<String> |
NEIN |
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.