Cloud Storage referansına bir dosya yükledikten sonra, dosya meta verilerini de alabilir veya güncelleyebilirsiniz (örneğin, içerik türünü güncellemek için). Dosyalar, ek dosya meta verileriyle birlikte özel anahtar/değer çiftlerini de depolayabilir.
Dosya Meta Verilerini Alma
Dosya meta verileri, contentDisposition
ve timeCreated
gibi daha az kullanılan bazı ö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
veya Promise
reddederse bir hata döndürür.
Web modüler API
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 ad alanı API'si
// 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, istediğiniz zaman updateMetadata()
yöntemini kullanarak dosya meta verilerini 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 tüm özellikler değiştirilmeden bırakılır. updateMetadata()
, meta verilerin tamamını içeren bir Promise
veya Promise
reddederse hata döndürür.
Web modüler API
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 ad alanı API'si
// 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 modüler API
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 ad alanı API'si
// 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ı Giderme
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. Hatalar hakkında daha fazla bilgiyi belgelerin İşleyici Hataları bölümünde bulabilirsiniz.
Özel Meta Veriler
Özel meta veriyi, String
özelliklerini içeren bir nesne olarak belirtebilirsiniz.
Web modüler API
const metadata = { customMetadata: { 'location': 'Yosemite, CA, USA', 'activity': 'Hiking' } };
Web ad alanı API'si
var metadata = { customMetadata: { 'location': 'Yosemite, CA, USA', 'activity': 'Hiking' } };
Her bir dosya için uygulamaya özgü ek verileri depolamak amacıyla özel meta veriler kullanabilirsiniz ancak bu tür verileri depolamak ve senkronize etmek için bir veritabanı (Firebase Realtime Database gibi) 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 sırasında EVET, updateMetadata'da HAYIR |
cacheControl |
dize | EVET |
contentDisposition |
dize | EVET |
contentEncoding |
dize | EVET |
contentLanguage |
dize | EVET |
contentType |
dize | EVET |
customMetadata |
Dize->dize eşlemeleri içeren nesne | EVET |
Dosya yüklemek, indirmek ve güncellemek önemlidir ancak bunları kaldırabilmek de önemlidir. Şimdi Cloud Storage'dan dosya silme işlemini nasıl yapacağınızı öğrenelim.