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

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

ध्यान दें: डिफ़ॉल्ट रूप से, बकेट के डेटा या फ़ाइलों पर कोई भी कार्रवाई करने के लिए, Cloud Storage for Firebase बकेट को Firebase Authentication की ज़रूरत होती है. Cloud Storage के लिए, Firebase Security Rules को बदला जा सकता है, ताकि खास स्थितियों में बिना पुष्टि के ऐक्सेस की अनुमति दी जा सके. हालांकि, ज़्यादातर मामलों में हमारा सुझाव है कि आप ऐक्सेस को सीमित करें और सुरक्षा के कड़े नियम सेट अप करें. खास तौर पर, प्रोडक्शन ऐप्लिकेशन के लिए. ध्यान दें कि अगर Google App Engine का इस्तेमाल किया जाता है और आपके पास *.appspot.com नाम के फ़ॉर्मैट वाली डिफ़ॉल्ट Cloud Storage बकेट है, तो आपको यह देखना पड़ सकता है कि सुरक्षा के नियम, App Engine फ़ाइलों के ऐक्सेस पर कैसे असर डालते हैं.

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

फ़ाइल के मेटाडेटा में name, size, और contentType (इसे अक्सर एमआईएमई टाइप कहा जाता है) जैसी सामान्य प्रॉपर्टी शामिल होती हैं. इसके अलावा, इसमें contentDisposition और timeCreated जैसी कुछ कम सामान्य प्रॉपर्टी भी शामिल होती हैं. इस मेटाडेटा को getMetadata() तरीके का इस्तेमाल करके, Cloud Storage के रेफ़रंस से वापस पाया जा सकता है.

// Create reference to the file whose metadata we want to retrieve
final forestRef = storageRef.child("images/forest.jpg");

// Get metadata properties
final metadata = await forestRef.getMetadata();

// Metadata now contains the metadata for 'images/forest.jpg'

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

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

// Create reference to the file whose metadata we want to change
final forestRef = storageRef.child("images/forest.jpg");

// Create file metadata to update
final newMetadata = SettableMetadata(
  cacheControl: "public,max-age=300",
  contentType: "image/jpeg",
);

// Update metadata properties
final metadata = await forestRef.updateMetadata(newMetadata);

// Updated metadata for 'images/forest.jpg' is returned

null को पास करके, मेटाडेटा की ऐसी प्रॉपर्टी मिटाई जा सकती हैं जिनमें बदलाव किया जा सकता है:

// Delete the cacheControl property
final newMetadata = SettableMetadata(cacheControl: null);
final metadata = await forestRef.updateMetadata(newMetadata);

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

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

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

SettableMetadata कंस्ट्रक्टर के customMetadata पैरामीटर का इस्तेमाल करके, कस्टम मेटाडेटा तय किया जा सकता है:

// Create reference to the file whose metadata we want to change
final forestRef = storageRef.child("images/forest.jpg");

// Create file metadata to update
final newCustomMetadata = SettableMetadata(
  customMetadata: {
    "location": "Yosemite, CA, USA",
    "activity": "Hiking",
  },
);

// Update metadata properties
final metadata = await forestRef.updateMetadata(newCustomMetadata);

// Updated metadata for 'images/forest.jpg' is returned

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

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

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

प्रॉपर्टी	टाइप	क्या इसे सेट किया जा सकता है?
bucket	String	नहीं
generation	String	नहीं
metageneration	String	नहीं
metadataGeneration	String	नहीं
fullPath	String	नहीं
name	String	नहीं
size	int	नहीं
timeCreated	DateTime	नहीं
updated	DateTime	नहीं
md5Hash	String	नहीं
cacheControl	String	हां
contentDisposition	String	हां
contentEncoding	String	हां
contentLanguage	String	हां
contentType	String	हां
customMetadata	Map<String, String>	हां

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