वेब पर संग्रहण संदर्भ बनाएं

आपकी फ़ाइलें Google क्लाउड स्टोरेज बाल्टी में संग्रहीत हैं। इस बाल्टी में फाइलें एक पदानुक्रमित संरचना में प्रस्तुत की जाती हैं, जैसे आपकी स्थानीय हार्ड डिस्क पर फ़ाइल सिस्टम या फायरबेस रियलटाइम डेटाबेस में डेटा। किसी फ़ाइल का संदर्भ बनाकर, आपका ऐप उस तक पहुंच प्राप्त करता है। फिर इन संदर्भों का उपयोग डेटा अपलोड या डाउनलोड करने, मेटाडेटा प्राप्त करने या अपडेट करने या फ़ाइल को हटाने के लिए किया जा सकता है। एक संदर्भ या तो एक विशिष्ट फ़ाइल या पदानुक्रम में उच्च स्तर के नोड को इंगित कर सकता है।

यदि आपने Firebase Realtime Database का उपयोग किया है, तो ये मार्ग आपको बहुत परिचित लग सकते हैं - उन्हें करना चाहिए! हालाँकि, आपका फ़ाइल डेटा Google क्लाउड स्टोरेज में संग्रहित है, रियलटाइम डेटाबेस में नहीं ।

एक संदर्भ बनाएँ

फ़ाइलों को अपलोड या डाउनलोड करने, फ़ाइलों को हटाने या मेटाडेटा प्राप्त करने या अपडेट करने के लिए, आपको उस फ़ाइल का संदर्भ बनाना होगा जिसे आप संचालित करना चाहते हैं। एक संदर्भ को क्लाउड में एक फ़ाइल के लिए एक संकेतक के रूप में सोचा जा सकता है। संदर्भ हल्के हैं, इसलिए आप जितनी चाहें उतने बना सकते हैं, और वे कई कार्यों के लिए पुन: प्रयोज्य भी हैं।

अपने फायरबेस ऐप में storage() सेवा से संदर्भ बनाएं। यह संदर्भ आपके क्लाउड स्टोरेज बाल्टी की जड़ की ओर इशारा करता है।

// Get a reference to the storage service, which is used to create references in your storage bucket
var storage = firebase.storage();

// Create a storage reference from our storage service
var storageRef = storage.ref();

आप एक मौजूदा संदर्भ पर child() पद्धति का उपयोग करके पेड़ में निचले स्थान पर एक संदर्भ बना सकते हैं, 'images/space.jpg' कह सकते हैं।

// Create a child reference
var imagesRef = storageRef.child('images');
// imagesRef now points to 'images'

// Child references can also take paths delimited by '/'
var spaceRef = storageRef.child('images/space.jpg');
// spaceRef now points to "images/space.jpg"
// imagesRef still points to "images"

संदर्भों के साथ नेविगेट करें

फ़ाइल पदानुक्रम को नेविगेट करने के लिए आप parent और root गुणों का भी उपयोग कर सकते हैं। parent एक स्तर तक नेविगेट करता है, जबकि root शीर्ष पर सभी तरह से नेविगेट करता है।

// Parent allows us to move to the parent of a reference
var imagesRef = spaceRef.parent;
// imagesRef now points to 'images'

// Root allows us to move all the way back to the top of our bucket
var rootRef = spaceRef.root;
// rootRef now points to the root

child() , parent , और root को कई बार एक साथ जंजीर में डाला जा सकता है, क्योंकि प्रत्येक एक संदर्भ देता है। अपवाद root का parent है, जो null ।

// References can be chained together multiple times
var earthRef = spaceRef.parent.child('earth.jpg');
// earthRef points to 'images/earth.jpg'

// nullRef is null, since the parent of root is null
var nullRef = spaceRef.root.parent;

संदर्भ गुण

आप उन फ़ाइलों को बेहतर ढंग से समझने के लिए संदर्भों का निरीक्षण कर सकते हैं जो वे fullPath , name और bucket गुणों का उपयोग करने के लिए इंगित करते हैं। इन गुणों को फ़ाइल का पूर्ण पथ, फ़ाइल का नाम, और फ़ाइल को बाल्टी में संग्रहीत किया जाता है।

// Reference's path is: 'images/space.jpg'
// This is analogous to a file path on disk
spaceRef.fullPath;

// Reference's name is the last segment of the full path: 'space.jpg'
// This is analogous to the file name
spaceRef.name;

// Reference's bucket is the name of the storage bucket where files are stored
spaceRef.bucket;

सन्दर्भ पर सीमाएँ

संदर्भ पथ और नामों में मान्य यूनिकोड वर्णों का कोई भी अनुक्रम हो सकता है, लेकिन कुछ प्रतिबंध शामिल हैं:

जब UTF-8 कूटबद्ध किया जाता है, तो reference.fullPath की कुल लंबाई .fullPath 1 और 1024 बाइट्स के बीच होनी चाहिए।
कोई कैरिज रिटर्न या लाइन फीड वर्ण नहीं।
# , [ , ] , * , या का उपयोग करने से बचें ? , क्योंकि ये अन्य उपकरणों जैसे Firebase Realtime Database या gsutil के साथ अच्छी तरह से काम नहीं करते हैं।

पूर्ण उदाहरण

// Points to the root reference
var storageRef = firebase.storage().ref();

// Points to 'images'
var imagesRef = storageRef.child('images');

// Points to 'images/space.jpg'
// Note that you can use variables to create child values
var fileName = 'space.jpg';
var spaceRef = imagesRef.child(fileName);

// File path is 'images/space.jpg'
var path = spaceRef.fullPath

// File name is 'space.jpg'
var name = spaceRef.name

// Points to 'images'
var imagesRef = spaceRef.parent;

आगे, चलिए क्लाउड स्टोरेज में फाइल अपलोड करने का तरीका जानें।