वेब पर Cloud Storage के साथ फ़ाइल मेटाडेटा इस्तेमाल करना

Cloud Storage पहचान फ़ाइल अपलोड करने के बाद, फ़ाइल का मेटाडेटा भी पाया या अपडेट किया जा सकता है. उदाहरण के लिए, कॉन्टेंट टाइप को अपडेट करने के लिए. फ़ाइलें, फ़ाइल के अतिरिक्त मेटाडेटा के साथ कस्टम कुंजी/वैल्यू पेयर भी सेव कर सकती हैं.

फ़ाइल का मेटाडेटा पाना

फ़ाइल के मेटाडेटा में, name, size, और contentType (इसे अक्सर MIME टाइप कहा जाता है) जैसी सामान्य प्रॉपर्टी के साथ-साथ, contentDisposition और timeCreated जैसी कुछ कम सामान्य प्रॉपर्टी भी शामिल होती हैं. इस मेटाडेटा को Cloud Storage रेफ़रंस से getMetadata() तरीके का इस्तेमाल करके वापस पाया जा सकता है. getMetadata() फ़ंक्शन, पूरा मेटाडेटा दिखाने वाला Promise दिखाता है. अगर Promise अस्वीकार कर दिया जाता है, तो गड़बड़ी दिखाता है.

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

फ़ाइल का मेटाडेटा अपडेट करना

फ़ाइल अपलोड होने के बाद, updateMetadata() तरीके का इस्तेमाल करके, फ़ाइल के मेटाडेटा को कभी भी अपडेट किया जा सकता है. कौनसी प्रॉपर्टी अपडेट की जा सकती हैं, इस बारे में ज़्यादा जानने के लिए पूरी सूची देखें. सिर्फ़ मेटाडेटा में दी गई प्रॉपर्टी अपडेट की जाती हैं. बाकी सभी प्रॉपर्टी में कोई बदलाव नहीं किया जाता. updateMetadata(), पूरा मेटाडेटा शामिल करने वाला Promise दिखाता है. अगर Promise अस्वीकार कर देता है, तो गड़बड़ी दिखाता है.

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

मेटाडेटा प्रॉपर्टी को null पर सेट करके मिटाया जा सकता है:

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

गड़बड़ियां ठीक करना

मेटाडेटा पाने या उसे अपडेट करने के दौरान गड़बड़ियां होने की कई वजहें हो सकती हैं. जैसे, फ़ाइल का मौजूद न होना या उपयोगकर्ता के पास, फ़ाइल को ऐक्सेस करने की अनुमति न होना. गड़बड़ियों के बारे में ज़्यादा जानकारी, दस्तावेज़ के गड़बड़ियां ठीक करना सेक्शन में मिल सकती है.

कस्टम मेटाडेटा

कस्टम मेटाडेटा को String प्रॉपर्टी वाले ऑब्जेक्ट के तौर पर सेट किया जा सकता है.

Web

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

Web

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

हर फ़ाइल के लिए, ऐप्लिकेशन से जुड़ा अतिरिक्त डेटा सेव करने के लिए कस्टम मेटाडेटा का इस्तेमाल किया जा सकता है. हालांकि, हम इस तरह के डेटा को सेव और सिंक करने के लिए, डेटाबेस (जैसे कि Firebase Realtime Database) का इस्तेमाल करने का सुझाव देते हैं.

फ़ाइल के मेटाडेटा की प्रॉपर्टी

किसी फ़ाइल पर मौजूद मेटाडेटा प्रॉपर्टी की पूरी सूची यहां दी गई है:

प्रॉपर्टी टाइप लिखा जा सकता है
bucket स्ट्रिंग नहीं
generation स्ट्रिंग नहीं
metageneration स्ट्रिंग नहीं
fullPath स्ट्रिंग नहीं
name स्ट्रिंग नहीं
size नंबर नहीं
timeCreated स्ट्रिंग नहीं
updated स्ट्रिंग नहीं
md5Hash स्ट्रिंग अपलोड करने पर YES और updateMetadata पर NO
cacheControl स्ट्रिंग YES
contentDisposition स्ट्रिंग YES
contentEncoding स्ट्रिंग YES
contentLanguage स्ट्रिंग YES
contentType स्ट्रिंग YES
customMetadata स्ट्रिंग->स्ट्रिंग मैपिंग वाला ऑब्जेक्ट YES

फ़ाइलों को अपलोड, डाउनलोड, और अपडेट करना ज़रूरी है. हालांकि, उन्हें हटाने का विकल्प भी होना चाहिए. आइए, Cloud Storage से फ़ाइलें मिटाने का तरीका जानें.