Flutter'da Cloud Storage ile dosya meta verilerini kullanma

Bir dosyayı Cloud Storage referansına yükledikten sonra, dosya meta verilerini de alıp güncelleyebilirsiniz (ör. içerik türünü görüntülemek veya güncellemek için). Dosyalar, ek dosya meta verileriyle özel anahtar/değer çiftleri de depolayabilir.

Dosya Meta Verilerini Alma

Dosya meta verileri, contentDisposition ve timeCreated gibi daha az yaygın olan özelliklerin yanı sıra name, size ve contentType (genellikle MIME türü olarak adlandırılır) gibi yaygın ö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ü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

null ile yazılabilir meta veri özelliklerini silebilirsiniz:

// Delete the cacheControl property
final newMetadata = SettableMetadata(cacheControl: null);
final metadata = await forestRef.updateMetadata(newMetadata);

Hataları işleme

Meta veri alınırken veya güncellenirken, dosyanın mevcut olmaması ya da kullanıcının istenen dosyaya erişim izninin olmaması gibi çeşitli nedenler vardır. Hatalarla ilgili daha fazla bilgiyi dokümanların Hataları ele alma bölümünde bulabilirsiniz.

Özel Meta Veriler

SettableMetadata yapıcısının customMetadata 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 dosyanın uygulamaya özgü verilerini özel meta verilerde saklayabilirsiniz ancak bu tür verileri depolamak ve senkronize etmek için bir veritabanı (ör. Firebase Gerçek Zamanlı Veritabanı) 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

Dosya yükleme, indirme ve güncelleme kadar dosyaları kaldırabilmek de önemlidir. Cloud Storage'dan dosyaları nasıl sileceğinizi öğrenelim.