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 özel anahtar/değer çiftlerini ek dosya meta verileriyle birlikte 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 contentDisposition ve timeCreated gibi yaygın örnekler. Bu meta veri, Cloud Storage referansından alındı: getMetadata() yöntemi. getMetadata(), şunu içeren bir Promise döndürür: ya da Promise reddederse bir hata oluşur.

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

// 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). Daha fazla bilgi için özellikleri hakkında daha fazla bilgi için tam listeye güncellenebilir. Yalnızca meta veride belirtilen özellikler güncellenir, diğer tüm değişiklikler değiştirilmeden bırakılır. updateMetadata(), Promise değeri döndürüyor içerir veya Promise reddetmesi durumunda bir hata verir.

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

// 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:

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

// 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ı Giderme

Bilgileri alma veya güncelleme sırasında hataların oluşmasının birkaç nedeni vardır: mevcut olmayan veya kullanıcının izni olmayan kullanıcı da dahil olmak üzere meta veriler istediğiniz dosyaya erişin. Hatalarla ilgili daha fazla bilgiyi şurada bulabilirsiniz: Hataları İşleme bölümünde bulabilirsiniz.

Özel Meta Veriler

Özel meta veriyi, String özelliklerini içeren bir nesne olarak belirtebilirsiniz.

const metadata = {
  customMetadata: {
    'location': 'Yosemite, CA, USA',
    'activity': 'Hiking'
  }
};
storage_custom_metadata.js

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

Her biri için uygulamaya özel ek verileri depolamak amacıyla özel meta veriler kullanabilirsiniz ancak bir veritabanı (ör. Firebase Realtime Database) depolama ve senkronize etme olanağı sunar.

Dosya Meta Verisi Özellikleri

Bir dosyadaki meta veri özelliklerinin tam listesini aşağıda bulabilirsiniz:

Dosya yüklemek, indirmek ve güncellemek önemlidir ancak tıklayın. Şimdi nasıl uygulayacağımızı dosyaları sil Cloud Storage'dan edinilebilir.