Cloud Storage on Web ile dosya meta verilerini kullanma

Cloud Storage referansına dosya yükledikten sonra şunu da alabilirsiniz: veya dosya meta verilerini güncelleyin (örneğin, 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 name, size ve contentType (genellikle MIME türü olarak adlandırılır) ve daha az daha yaygın olanları (ör. contentDisposition ve timeCreated) Bu meta veriler, getMetadata() yöntemi kullanılarak bir Cloud Storage referansından alınabilir. getMetadata(), şunu içeren bir Promise döndürür: tüm meta verileri veya Promise reddederse bir hata oluşur.

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!
  });
storage_get_metadata.js

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!
  });
file-metadata.js

Dosya Meta Verilerini Güncelleme

Dosya meta verilerini, dosya yüklemesi tamamlandıktan sonra istediğiniz zaman (updateMetadata() yöntemini kullanarak). 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. 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!
  });
storage_update_metadata.js

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!
  });
file-metadata.js

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!
  });
storage_delete_metadata.js

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!
  });
file-metadata.js

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 şurada bulabilirsiniz: Hataları İşleme 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'
  }
};
storage_custom_metadata.js

Web

var metadata = {
  customMetadata: {
    'location': 'Yosemite, CA, USA',
    'activity': 'Hiking'
  }
};
file-metadata.js

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 Veri Ö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 tıklayın. Şimdi nasıl uygulayacağımızı dosyaları sil başlangıç fiyatı: Cloud Storage.