Cloud Storage referansına bir dosya yükledikten sonra, dosya meta verilerini de alabilir veya güncelleyebilirsiniz (ör. içerik türünü 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. getMetadata()
, tüm meta verileri içeren bir Promise
döndürür veya Promise
reddederse bir hata döndürür.
Web
import { getStorage, ref, getMetadata } from "firebase/storage"; // Create a reference to the file whose metadata we want to retrieve const storage = getStorage(); const forestRef = ref(storage, 'images/forest.jpg'); // Get metadata properties getMetadata(forestRef) .then((metadata) => { // Metadata now contains the metadata for 'images/forest.jpg' }) .catch((error) => { // Uh-oh, an error occurred! });
Web
// Create a reference to the file whose metadata we want to retrieve var forestRef = storageRef.child('images/forest.jpg'); // Get metadata properties forestRef.getMetadata() .then((metadata) => { // Metadata now contains the metadata for 'images/forest.jpg' }) .catch((error) => { // Uh-oh, an error occurred! });
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 veride belirtilen özellikler güncellenir, diğer özellikler değiştirilmeden bırakılır. updateMetadata()
, meta verilerin tamamını içeren bir Promise
döndürür veya Promise
reddederse bir hata döndürür.
Web
import { getStorage, ref, updateMetadata } from "firebase/storage"; // Create a reference to the file whose metadata we want to change const storage = getStorage(); const forestRef = ref(storage, 'images/forest.jpg'); // Create file metadata to update const newMetadata = { cacheControl: 'public,max-age=300', contentType: 'image/jpeg' }; // Update metadata properties updateMetadata(forestRef, newMetadata) .then((metadata) => { // Updated metadata for 'images/forest.jpg' is returned in the Promise }).catch((error) => { // Uh-oh, an error occurred! });
Web
// Create a reference to the file whose metadata we want to change var forestRef = storageRef.child('images/forest.jpg'); // Create file metadata to update var newMetadata = { cacheControl: 'public,max-age=300', contentType: 'image/jpeg' }; // Update metadata properties forestRef.updateMetadata(newMetadata) .then((metadata) => { // Updated metadata for 'images/forest.jpg' is returned in the Promise }).catch((error) => { // Uh-oh, an error occurred! });
Bir meta veri mülkünü null
olarak ayarlayarak silebilirsiniz:
Web
import { getStorage, ref, updateMetadata } from "firebase/storage"; const storage = getStorage(); const forestRef = ref(storage, 'images/forest.jpg'); // Create file metadata with property to delete const deleteMetadata = { contentType: null }; // Delete the metadata property updateMetadata(forestRef, deleteMetadata) .then((metadata) => { // metadata.contentType should be null }).catch((error) => { // Uh-oh, an error occurred! });
Web
// Create file metadata with property to delete var deleteMetadata = { contentType: null }; // Delete the metadata property forestRef.updateMetadata(deleteMetadata) .then((metadata) => { // metadata.contentType should be null }).catch((error) => { // Uh-oh, an error occurred! });
Hataları iş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ı bu nedenler arasındadır. Hatalarla ilgili daha fazla bilgiyi dokümanların Hataları ele alma bölümünde bulabilirsiniz.
Özel Meta Veriler
Özel meta verileri, String
mülkleri içeren bir nesne olarak belirtebilirsiniz.
Web
const metadata = { customMetadata: { 'location': 'Yosemite, CA, USA', 'activity': 'Hiking' } };
Web
var metadata = { customMetadata: { 'location': 'Yosemite, CA, USA', 'activity': 'Hiking' } };
Her dosyada uygulamaya özgü ek verileri depolamak için özel meta verileri kullanabilirsiniz 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 | Yazılabilir |
---|---|---|
bucket |
dize | HAYIR |
generation |
dize | HAYIR |
metageneration |
dize | HAYIR |
fullPath |
dize | HAYIR |
name |
dize | HAYIR |
size |
sayı | HAYIR |
timeCreated |
dize | HAYIR |
updated |
dize | HAYIR |
md5Hash |
dize | Yükleme için EVET, updateMetadata için HAYIR |
cacheControl |
dize | EVET |
contentDisposition |
dize | EVET |
contentEncoding |
dize | EVET |
contentLanguage |
dize | EVET |
contentType |
dize | EVET |
customMetadata |
Dize->dize eşlemelerini içeren nesne | EVET |
Dosya yükleme, indirme ve güncelleme kadar dosyaları kaldırabilmek de önemlidir. Cloud Storage'den dosyaları nasıl sileceğinizi öğrenelim.