Cloud Storage referansına bir dosya yükledikten sonra, dosya meta verilerini (ör. içerik türünü görüntülemek veya güncellemek için) de alabilir ve güncelleyebilirsiniz. Dosyalar, ek dosya meta verileriyle özel anahtar/değer çiftlerini de saklayabilir.
Dosya meta verilerini alma
Dosya meta verileri, name, size ve contentType (genellikle MIME türü olarak adlandırılır) gibi yaygın özelliklerin yanı sıra contentDisposition ve timeCreated gibi daha az yaygın olan bazı özellikleri içerir. Bu meta veriler, getMetadata() yöntemi kullanılarak Cloud Storage referansından alınabilir.
// 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'
Dosya meta verilerini güncelleme
Dosya yükleme işlemi tamamlandıktan sonra updateMetadata() yöntemini kullanarak dosya meta verilerini istediğiniz zaman güncelleyebilirsiniz. Hangi özelliklerin güncellenebileceği hakkında daha fazla bilgi için tam listeye bakın. Yalnızca meta verilerde belirtilen özellikler güncellenir, diğer tüm özellikler değiştirilmeden bırakılır.
// 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
Yazılabilir meta veri özelliklerini null ileterek silebilirsiniz:
// Delete the cacheControl property
final newMetadata = SettableMetadata(cacheControl: null);
final metadata = await forestRef.updateMetadata(newMetadata);
Hataları İşleme
Meta verileri alma veya güncelleme sırasında hataların oluşmasının çeşitli nedenleri vardır. Örneğin, dosyanın mevcut olmaması veya kullanıcının istenen dosyaya erişme izninin olmaması. Hatalar hakkında daha fazla bilgiyi dokümanların Hataları İşleme bölümünde bulabilirsiniz.
Özel Meta Veriler
customMetadata oluşturucusunun SettableMetadata parametresini kullanarak özel meta veriler belirtebilirsiniz:
// 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
Her dosya için uygulamaya özel verileri özel meta verilerde depolayabilirsiniz ancak bu tür verileri depolamak ve senkronize etmek için bir veritabanı (ör. Firebase Realtime Database) kullanmanızı önemle tavsiye ederiz.
Dosya Meta Verisi Özellikleri
Bir dosyadaki meta veri özelliklerinin tam listesini aşağıda bulabilirsiniz:
| Özellik | Tür | Ayarlanabilir mi? |
|---|---|---|
bucket |
String |
Hayır |
generation |
String |
Hayır |
metageneration |
String |
Hayır |
metadataGeneration |
String |
Hayır |
fullPath |
String |
Hayır |
name |
String |
Hayır |
size |
int |
Hayır |
timeCreated |
DateTime |
Hayır |
updated |
DateTime |
Hayır |
md5Hash |
String |
Hayır |
cacheControl |
String |
Evet |
contentDisposition |
String |
Evet |
contentEncoding |
String |
Evet |
contentLanguage |
String |
Evet |
contentType |
String |
Evet |
customMetadata |
Map<String, String> |
Evet |
Dosyaları yüklemek, indirmek ve güncellemek önemlidir ancak bunları kaldırabilmek de önemlidir. Cloud Storage'dan dosyaları nasıl sileceğinizi öğrenelim.