Flutter'da Cloud Storage ile dosya meta verilerini kullanma

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

Not: Varsayılan olarak, bir Cloud Storage for Firebase paketinin verileri veya dosyaları üzerinde herhangi bir işlem yapmak için Firebase Authentication gerekir. Cloud Storage için Firebase Security Rules ayarınızı değiştirerek belirli durumlarda kimliği doğrulanmamış erişime izin verebilirsiniz. Ancak çoğu durumda, erişimi kısıtlamanızı ve güçlü güvenlik kuralları oluşturmanızı (özellikle üretim uygulamaları için) önemle tavsiye ederiz. Google App Engine kullanıyorsanız ve adı *.appspot.com biçiminde olan varsayılan bir Cloud Storage paketiniz varsa güvenlik kurallarınızın App Engine dosyalarına erişimi nasıl etkilediğini göz önünde bulundurmanız gerekebilir.

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 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ğ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 değerini 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 hata oluşmasının çeşitli nedenleri olabilir. Örneğin, dosyanın mevcut olmaması veya kullanıcının istenen dosyaya erişim izninin olmaması. Hatalar hakkında daha fazla bilgiyi belgelerin Hataları İşleme bölümünde bulabilirsiniz.

Özel Meta Veriler

SettableMetadata oluşturucusunun 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 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 Veri Ö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. Dosyaları Cloud Storage'dan nasıl sileceğinizi öğrenelim.