फायरबेस के लिए क्लाउड स्टोरेज आपको अपने क्लाउड स्टोरेज बकेट की सामग्री को सूचीबद्ध करने की अनुमति देता है। एसडीके वर्तमान क्लाउड स्टोरेज संदर्भ के तहत आइटम और ऑब्जेक्ट के उपसर्ग दोनों लौटाते हैं।
सूची एपीआई का उपयोग करने वाले प्रोजेक्टों को फायरबेस नियम संस्करण 2 के लिए क्लाउड स्टोरेज की आवश्यकता होती है। यदि आपके पास मौजूदा फायरबेस प्रोजेक्ट है, तो सुरक्षा नियम गाइड में दिए गए चरणों का पालन करें।
list()
Google क्लाउड स्टोरेज सूची एपीआई का उपयोग करती है। फायरबेस के लिए क्लाउड स्टोरेज में, हम एक सीमांकक के रूप में /
का उपयोग करते हैं, जो हमें फ़ाइल सिस्टम शब्दार्थ का अनुकरण करने की अनुमति देता है। बड़े, पदानुक्रमित क्लाउड स्टोरेज बकेट के कुशल ट्रैवर्सल की अनुमति देने के लिए, सूची एपीआई उपसर्ग और आइटम अलग से लौटाता है। उदाहरण के लिए, यदि आप एक फ़ाइल /images/uid/file1
अपलोड करते हैं,
-
root.child('images').listAll()
उपसर्ग के रूप में/images/uid
लौटाएगा। -
root.child('images/uid').listAll()
फ़ाइल को एक आइटम के रूप में लौटाएगा।
फायरबेस एसडीके के लिए क्लाउड स्टोरेज उन ऑब्जेक्ट पथों को वापस नहीं लौटाता है जिनमें दो लगातार /
एस होते हैं या /.
. उदाहरण के लिए, एक बाल्टी पर विचार करें जिसमें निम्नलिखित वस्तुएं हैं:
-
correctPrefix/happyItem
-
wrongPrefix//sadItem
-
lonelyItem/
इस बकेट में आइटमों पर सूची संचालन निम्नलिखित परिणाम देगा:
- रूट पर सूची ऑपरेशन
correctPrefix
,wrongPrefix
औरlonelyItem
के संदर्भ कोprefixes
के रूप में लौटाता है। -
correctPrefix/
पर सूची ऑपरेशनitems
के रूप मेंcorrectPrefix/happyItem
के संदर्भ लौटाता है। -
wrongPrefix/
पर सूची कार्रवाई कोई संदर्भ नहीं लौटाती क्योंकिwrongPrefix//sadItem
में लगातार दो/
s शामिल हैं। -
lonelyItem/
पर सूची ऑपरेशन कोई संदर्भ नहीं लौटाता क्योंकि ऑब्जेक्टlonelyItem/
/
के साथ समाप्त होता है।
सभी फाइलों की सूची बनाएं
किसी निर्देशिका के सभी परिणाम लाने के लिए आप listAll
उपयोग कर सकते हैं। यह छोटी निर्देशिकाओं के लिए सबसे अच्छा उपयोग किया जाता है क्योंकि सभी परिणाम मेमोरी में बफ़र किए जाते हैं। यदि प्रक्रिया के दौरान ऑब्जेक्ट जोड़े या हटाए जाते हैं तो ऑपरेशन एक सुसंगत स्नैपशॉट भी नहीं लौटा सकता है।
एक बड़ी सूची के लिए, पृष्ठांकित list()
विधि का उपयोग करें क्योंकि listAll()
सभी परिणामों को मेमोरी में बफ़र करता है।
निम्नलिखित उदाहरण listAll
प्रदर्शित करता है।
Web modular API
import { getStorage, ref, listAll } from "firebase/storage"; const storage = getStorage(); // Create a reference under which you want to list const listRef = ref(storage, 'files/uid'); // Find all the prefixes and items. listAll(listRef) .then((res) => { res.prefixes.forEach((folderRef) => { // All the prefixes under listRef. // You may call listAll() recursively on them. }); res.items.forEach((itemRef) => { // All the items under listRef. }); }).catch((error) => { // Uh-oh, an error occurred! });
Web namespaced API
// Create a reference under which you want to list var listRef = storageRef.child('files/uid'); // Find all the prefixes and items. listRef.listAll() .then((res) => { res.prefixes.forEach((folderRef) => { // All the prefixes under listRef. // You may call listAll() recursively on them. }); res.items.forEach((itemRef) => { // All the items under listRef. }); }).catch((error) => { // Uh-oh, an error occurred! });
सूची परिणाम पृष्ठांकित करें
list()
एपीआई अपने द्वारा लौटाए जाने वाले परिणामों की संख्या पर एक सीमा लगाती है। list()
एक सुसंगत पृष्ठदृश्य प्रदान करती है और एक पृष्ठटोकन को उजागर करती है जो अतिरिक्त परिणाम लाने के समय पर नियंत्रण की अनुमति देता है।
पेजटोकन पिछले परिणाम में लौटाए गए अंतिम आइटम के पथ और संस्करण को एन्कोड करता है। पेजटोकन का उपयोग करते हुए बाद के अनुरोध में, पेजटोकन के बाद आने वाले आइटम दिखाए जाते हैं।
निम्नलिखित उदाहरण async/await
का उपयोग करके परिणाम को पेजिनेट करना दर्शाता है।
Web modular API
import { getStorage, ref, list } from "firebase/storage"; async function pageTokenExample(){ // Create a reference under which you want to list const storage = getStorage(); const listRef = ref(storage, 'files/uid'); // Fetch the first page of 100. const firstPage = await list(listRef, { maxResults: 100 }); // Use the result. // processItems(firstPage.items) // processPrefixes(firstPage.prefixes) // Fetch the second page if there are more elements. if (firstPage.nextPageToken) { const secondPage = await list(listRef, { maxResults: 100, pageToken: firstPage.nextPageToken, }); // processItems(secondPage.items) // processPrefixes(secondPage.prefixes) } }
Web namespaced API
async function pageTokenExample(){ // Create a reference under which you want to list var listRef = storageRef.child('files/uid'); // Fetch the first page of 100. var firstPage = await listRef.list({ maxResults: 100}); // Use the result. // processItems(firstPage.items) // processPrefixes(firstPage.prefixes) // Fetch the second page if there are more elements. if (firstPage.nextPageToken) { var secondPage = await listRef.list({ maxResults: 100, pageToken: firstPage.nextPageToken, }); // processItems(secondPage.items) // processPrefixes(secondPage.prefixes) } }
त्रुटियों को संभालें
यदि आपने सुरक्षा नियमों को संस्करण 2 में अपग्रेड नहीं किया है तो list()
और listAll()
एक अस्वीकृत वादा लौटाते हैं। यदि आपको यह त्रुटि दिखाई देती है तो अपने सुरक्षा नियमों को अपग्रेड करें:
Listing objects in a bucket is disallowed for rules_version = "1".
Please update storage security rules to rules_version = "2" to use list.
अन्य संभावित त्रुटियाँ यह संकेत दे सकती हैं कि उपयोगकर्ता के पास सही अनुमति नहीं है। त्रुटियों के बारे में अधिक जानकारी हैंडल एरर्स में पाई जा सकती है।