Bir dosyayı Cloud Storage referansına yükledikten sonra, örneğin içerik türünü görüntülemek veya güncellemek için dosya meta verilerini alıp güncelleyebilirsiniz. Dosyalar ayrıca ek dosya meta verileriyle birlikte özel anahtar/değer çiftlerini de depolayabilir.
Dosya Meta Verilerini Al
Dosya meta verileri, contentDisposition
ve timeCreated
gibi daha az yaygın olanların yanı sıra name
, size
ve contentType
(genellikle MIME türü olarak anılır) gibi ortak özellikleri içerir. Bu meta veriler, getMetadata()
yöntemi kullanılarak bir 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üncelle
Dosya meta verilerini, dosya yükleme işlemi tamamlandıktan sonra updateMetadata()
yöntemini kullanarak 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ğerleri 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ı İşle
Meta veri alınırken veya güncellenirken, dosyanın mevcut olmaması veya kullanıcının istenen dosyaya erişim iznine sahip olmaması da dahil olmak üzere hataların ortaya çıkmasının çeşitli nedenleri vardır. Hatalarla ilgili daha fazla bilgiyi dokümanların Hataları İşleme bölümünde bulabilirsiniz.
Özel Meta Veriler
SettableMetadata
yapıcısının customMetadata
parametresini kullanarak özel meta verileri 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 saklayabilirsiniz, ancak bu tür verileri depolamak ve senkronize etmek için bir veritabanı ( Firebase Gerçek Zamanlı Veritabanı gibi) kullanmanızı kesinlikle öneririz.
Dosya Meta Verisi Özellikleri
Bir dosyadaki meta veri özelliklerinin tam listesi aşağıda mevcuttur:
Mülk | Tip | Ayarlanabilir mi? |
---|---|---|
bucket | String | HAYIR |
generation | String | HAYIR |
metageneration | String | HAYIR |
metadataGeneration | String | HAYIR |
fullPath | String | HAYIR |
name | String | HAYIR |
size | int | HAYIR |
timeCreated | DateTime | HAYIR |
updated | DateTime | HAYIR |
md5Hash | String | HAYIR |
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ın nasıl silineceğini öğrenelim.