डेटा वापस लाया जा रहा है

जीईटी के साथ डेटा पढ़ना

हम Firebase डेटाबेस के यूआरएल के लिए GET अनुरोध जारी करके, उसका डेटा पढ़ सकते हैं एंडपॉइंट का इस्तेमाल करें. पिछले सेक्शन में दिए गए ब्लॉग के उदाहरण पर चलते हैं और अपनी ब्लॉग पोस्ट का सारा डेटा पढ़ते हैं:

curl 'https://docs-examples.firebaseio.com/fireblog/posts.json?print=pretty'

अनुरोध स्वीकार किए जाने पर, उसे 200 OK एचटीटीपी स्टेटस कोड और रिस्पॉन्स में वह डेटा शामिल होगा जिसे हम वापस ला रहे हैं.

यूआरआई पैरामीटर जोड़ना

हमारे Firebase डेटाबेस से डेटा पढ़ते समय, REST API कई क्वेरी पैरामीटर को स्वीकार करता है. सबसे ज़्यादा इस्तेमाल किए जाने वाले पैरामीटर यहां दिए गए हैं. पूरी सूची देखने के लिए, REST API का रेफ़रंस.

प्रमाणीकरण

auth अनुरोध पैरामीटर से सुरक्षित किए गए डेटा को ऐक्सेस किया जा सकता है Firebase Realtime Database Security Rules और है सभी तरह के अनुरोध पर काम करता है. तर्क आपके Firebase ऐप्लिकेशन का सीक्रेट या पुष्टि करने वाला टोकन, जैसा कि Firebase प्रोजेक्ट के उपयोगकर्ता में बताया गया है. यहां दिए गए उदाहरण में, हमने auth के साथ GET का अनुरोध भेजा है पैरामीटर है, जहां CREDENTIAL आपके Firebase ऐप्लिकेशन का सीक्रेट या पुष्टि करने के लिए टोकन:

curl 'https://docs-examples.firebaseio.com/auth-example.json?auth=CREDENTIAL'

प्रिंट करें

print=pretty तय करने पर, डेटा ऐसे फ़ॉर्मैट में मिलता है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.

curl 'https://docs-examples.firebaseio.com/fireblog/posts.json?print=pretty'

print=silent को तय करने से, सफलता मिलने पर 204 No Content दिखाता है.

curl 'https://docs-examples.firebaseio.com/fireblog/posts.json?print=silent'

कॉलबैक

वेब ब्राउज़र से सभी डोमेन पर REST कॉल करने के लिए, इनका इस्तेमाल किया जा सकता है जवाब को JavaScript में रैप करने के लिए JSONP कॉलबैक फ़ंक्शन. callback= जोड़ें, ताकि REST API, लौटाए गए डेटा को कॉलबैक फ़ंक्शन जिसे आपने तय किया है. उदाहरण के लिए:

<script>
  function gotData(data) {
    console.log(data);
  }
</script>
<script src="https://docs-examples.firebaseio.com/fireblog/posts.json?callback=gotData">

शैलो

यह एक ऐडवांस सुविधा है. इसे इस तरह से डिज़ाइन किया गया है कि इसकी मदद से, बिना किसी ज़रूरत के बड़े डेटासेट पर काम किया जा सके सबकुछ डाउनलोड करो. इसका इस्तेमाल करने के लिए, shallow=true को पैरामीटर के तौर पर जोड़ें. इससे, दिखाए जाने वाले डेटा की जानकारी कम हो जाएगी. अगर जगह का डेटा JSON प्रिमिटिव (स्ट्रिंग, संख्या, या बूलियन) है, तो इसका मान बस दिखाया जाएगा. अगर जगह का डेटा स्नैपशॉट JSON है ऑब्जेक्ट है, तो हर कुंजी के मान को छोटा करके सही कर दिया जाएगा. उदाहरण के लिए, यहां दिए गए डेटा का इस्तेमाल करके:

{
  "message": {
    "user": {
      "name": "Chris"
    },
    "body": "Hello!"
  }
}

// A request to /message.json?shallow=true
// would return the following:
{
  "user": true,
  "body": true
}

// A request to /message/body.json?shallow=true
// would simply return:
"Hello!"

इसे curl के इस अनुरोध के साथ आज़माएं:

curl 'https://docs-examples.firebaseio.com/rest/retrieving-data.json?shallow=true&print=pretty'

टाइम आउट

सर्वर साइड पर पढ़ने में लगने वाला समय सीमित करने के लिए इसका इस्तेमाल करें. अगर अनुरोध दिए गए समय में पूरा नहीं होता. यह एक एचटीटीपी से खत्म होता है 400 कोड वाली गड़बड़ी. यह तब खास तौर पर फ़ायदेमंद होता है, जब आपको थोड़ा डेटा ट्रांसफ़र करना हो और आपको बड़े सबट्री को फ़ेच करने के लिए बहुत देर तक इंतज़ार न करना हो. डेटा के साइज़ और कैश मेमोरी के हिसाब से, पढ़ने में लगने वाला असल समय अलग-अलग हो सकता है.

timeouts के बारे में बताने के लिए, इस फ़ॉर्मैट का इस्तेमाल करें: 3ms, नंबर और यूनिट के साथ 3s या 3min. अगर नहीं तय किए गए, 15min का ज़्यादा से ज़्यादा timeout होगा लागू किया गया. अगर timeout पॉज़िटिव नहीं है या तय सीमा से ज़्यादा है, तो अनुरोध को एचटीटीपी 400 वाली गड़बड़ी के साथ अस्वीकार कर दिया जाएगा. नीचे दिए गए उदाहरण में, GET अनुरोध में 10 सेकंड का timeout शामिल है.

curl 'https://docs-examples.firebaseio.com/rest/retrieving-data.json?timeout=10s'

डेटा फ़िल्टर करना

हम कई फ़ैक्टर के आधार पर डेटा को फ़िल्टर करने के लिए क्वेरी बना सकते हैं. सबसे पहले, आपको orderBy पैरामीटर का इस्तेमाल करके यह तय करना होगा कि आपको अपना डेटा कैसे फ़िल्टर करना है. इसके बाद, orderBy को इन पांच पैरामीटर में से किसी एक के साथ जोड़ें: limitToFirst, limitToLast, startAt, endAt, और equalTo.

Firebase में हम सभी को डायनासोर बहुत पसंद हैं. इसलिए, हम डायनासोर के बारे में तथ्यों के सैंपल डेटाबेस के स्निपेट का इस्तेमाल करके, यह दिखाएंगे कि डेटा को कैसे फ़िल्टर किया जा सकता है:

{
  "lambeosaurus": {
    "height": 2.1,
    "length": 12.5,
    "weight": 5000
  },
  "stegosaurus": {
    "height": 4,
    "length": 9,
    "weight": 2500
  }
}

हम डेटा को तीन में से किसी एक तरीके से फ़िल्टर कर सकते हैं: चाइल्ड की, की या वैल्यू के हिसाब से. क्वेरी इनमें से किसी एक पैरामीटर से शुरू होती है और फिर उसे इनमें से एक या ज़्यादा पैरामीटर के साथ जोड़ा जाना चाहिए: startAt, endAt, limitToFirst, limitToLast या equalTo.

किसी खास चाइल्ड कुंजी के हिसाब से फ़िल्टर करना

हम किसी सामान्य चाइल्ड कुंजी के हिसाब से नोड को फ़िल्टर कर सकते हैं. इसके लिए, हम उस कुंजी को orderBy के पास भेजते हैं पैरामीटर. उदाहरण के लिए, 3 से ज़्यादा ऊंचाई वाले सभी डायनासोर की जानकारी पाने के लिए, हम ये काम कर सकते हैं:

curl 'https://dinosaur-facts.firebaseio.com/dinosaurs.json?orderBy="height"&startAt=3&print=pretty'

जिस नोड में वह चाइल्ड कुंजी नहीं है जिस पर हम फ़िल्टर कर रहे हैं, तो उसे null. कि डेटा को डेटा को ऑर्डर करने का तरीका देखें.

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

{
  "lambeosaurus": {
    "dimensions": {
      "height" : 2.1,
      "length" : 12.5,
      "weight": 5000
    }
  },
  "stegosaurus": {
    "dimensions": {
      "height" : 4,
      "length" : 9,
      "weight" : 2500
    }
  }
}

ऊंचाई के बारे में क्वेरी करने के लिए, हम ऑब्जेक्ट के पूरे पाथ का इस्तेमाल करते हैं, न कि एक बटन का:

curl 'https://dinosaur-facts.firebaseio.com/dinosaurs.json?orderBy="dimensions/height"&startAt=3&print=pretty'

क्वेरी को एक बार में सिर्फ़ एक कुंजी के हिसाब से फ़िल्टर किया जा सकता है. एक ही अनुरोध में orderBy पैरामीटर का कई बार इस्तेमाल करने पर गड़बड़ी का मैसेज मिलता है.

बटन के हिसाब से फ़िल्टर करना

हम orderBy="$key" पैरामीटर का इस्तेमाल करके, नोड को उनकी कुंजियों के हिसाब से भी फ़िल्टर कर सकते हैं. कॉन्टेंट बनाने नीचे दिए गए उदाहरण में, a से m अक्षर से शुरू होने वाले सभी डायनासॉर के नाम शामिल हैं:

curl 'https://dinosaur-facts.firebaseio.com/dinosaurs.json?orderBy="$key"&startAt="a"&endAt="m"&print=pretty'

वैल्यू के हिसाब से फ़िल्टर करना

हम orderBy="$value" का इस्तेमाल करके, नोड को उनकी चाइल्ड कुंजियों की वैल्यू के हिसाब से फ़िल्टर कर सकते हैं पैरामीटर. मान लीजिए कि डायनासॉर के पास डायनो स्पोर्ट्स की प्रतियोगिता है और हम उसे नीचे दिए गए प्रारूप में अपने स्कोर ट्रैक करें:

{
  "scores": {
    "bruhathkayosaurus": 55,
    "lambeosaurus": 21,
    "linhenykus": 80,
    "pterodactyl": 93,
    "stegosaurus": 5,
    "triceratops": 22
  }
}

50 से ज़्यादा स्कोर वाले सभी डायनासॉर को वापस लाने के लिए, हम नीचे दिया गया अनुरोध कर सकते हैं:

curl 'https://dinosaur-facts.firebaseio.com/scores.json?orderBy="$value"&startAt=50&print=pretty'

डेटा को ऑर्डर करने का तरीका देखें. इससे आपको पता चलेगा कि null, बूलियन, स्ट्रिंग, और ऑब्जेक्ट वैल्यू को क्रम में लगाने का तरीका orderBy="$value".

जटिल फ़िल्टरिंग

ज़्यादा जटिल क्वेरी बनाने के लिए, हम कई पैरामीटर को जोड़ सकते हैं.

क्वेरी सीमित करना

limitToFirst और limitToLast पैरामीटर का इस्तेमाल बच्चों की ज़्यादा से ज़्यादा संख्या जिनके लिए डेटा लिया जाना है. अगर हमने 100 की सीमा सेट की है, तो हमें सिर्फ़ उतने ही बच्चे मिलेंगे जो इस सीमा के अंदर आते हैं. अगर हमारे डेटाबेस में 100 से कम मैसेज सेव हैं, तो हमें हर बच्चे का डेटा मिलेगा. हालांकि, यदि हमारे पास 100 से अधिक संदेश हैं, तो हम केवल में से 100 मैसेज के लिए डेटा मिल सकता है. ये सभी ऑर्डर किए गए पहले 100 मैसेज होंगे, अगर हम limitToFirst या ऑर्डर किए गए आखिरी 100 मैसेज का इस्तेमाल करके, limitToLast.

डायनासॉर से जुड़े तथ्यों के डेटाबेस और orderBy का इस्तेमाल करके, हम इन दोनों सबसे भारी डायनासॉर:

curl 'https://dinosaur-facts.firebaseio.com/dinosaurs.json?orderBy="weight"&limitToLast=2&print=pretty'

इसी तरह, हम limitToFirst का इस्तेमाल करके दो सबसे छोटे डायनासॉर का पता लगा सकते हैं:

curl 'https://dinosaur-facts.firebaseio.com/dinosaurs.json?orderBy="height"&limitToFirst=2&print=pretty'

हम orderBy="$value" का इस्तेमाल करके, क्वेरी की सीमा तय करने वाली क्वेरी भी कर सकते हैं. अगर हमें लगता है कि डायनो स्पोर्ट्स के सबसे ज़्यादा स्कोर करने वाले तीन प्रतिस्पर्धियों वाला लीडरबोर्ड फ़ॉलो किया जा रहा है:

curl 'https://dinosaur-facts.firebaseio.com/scores.json?orderBy="$value"&limitToLast=3&print=pretty'

रेंज क्वेरी

startAt, endAt, और equalTo का इस्तेमाल करके, अपनी क्वेरी के लिए, शुरू और खत्म होने के समय को अपनी पसंद के मुताबिक चुना जा सकता है. उदाहरण के लिए, अगर हम सभी डायनासॉर की लंबाई कम से कम तीन मीटर होती है. हम orderBy और startAt:

curl 'https://dinosaur-facts.firebaseio.com/dinosaurs.json?orderBy="height"&startAt=3&print=pretty'

हम endAt का इस्तेमाल करके, उन सभी डायनासोर का पता लगा सकते हैं जिनके नाम टेरोडैक्टिल से पहले आते हैं लेक्सिकोग्राफ़िक रूप से:

curl 'https://dinosaur-facts.firebaseio.com/dinosaurs.json?orderBy="$key"&endAt="pterodactyl"&print=pretty'

हम अपनी क्वेरी के दोनों सिरों को सीमित करने के लिए startAt और endAt को मिला सकते हैं. नीचे दिए गए उदाहरण में वे सभी डायनासोर मिले हैं जिनका नाम "b" अक्षर से शुरू होता है:

curl 'https://dinosaur-facts.firebaseio.com/dinosaurs.json?orderBy="$key"&startAt="b"&endAt="b\uf8ff"&print=pretty'

रेंज क्वेरी तब भी काम आती हैं, जब आपको अपने डेटा को पेजों में बांटना हो.

जानकारी को एक जगह इकट्ठा किया जा रहा है

मुश्किल क्वेरी बनाने के लिए, हम इन सभी तकनीकों को मिला सकते हैं. उदाहरण के लिए, शायद आपको ताकि उन सभी डायनासॉर के नाम खोजे जा सकें जिनकी लंबाई हमारे पसंदीदा डायनासॉर से छोटी या उसके बराबर है दयालु, स्टेगोसॉरस:

MY_FAV_DINO_HEIGHT=`curl "https://dinosaur-facts.firebaseio.com/dinosaurs/stegosaurus/height.json"`
curl "https://dinosaur-facts.firebaseio.com/dinosaurs.json?orderBy=\"height\"&endAt=${MY_FAV_DINO_HEIGHT}&print=pretty"

डेटा को ऑर्डर कैसे किया जाता है

इस सेक्शन में बताया गया है कि फ़िल्टर करने के तीनों पैरामीटर में से हर एक का इस्तेमाल करने पर, आपके डेटा को कैसे क्रम में लगाया जाता है.

orderBy

चाइल्ड कुंजी के नाम के साथ orderBy का इस्तेमाल करते समय, ऐसा डेटा जिसमें चाइल्ड कुंजी को इस तरह क्रम से लगाया जाएगा:

  1. तय की गई चाइल्ड कुंजी के लिए null वैल्यू वाले बच्चे पहले आते हैं.
  2. तय की गई चाइल्ड कुंजी के लिए false वैल्यू वाले बच्चे इसके बाद आते हैं. अगर आपने कई बच्चों की वैल्यू false है, उन्हें क्रम से लगाया गया है कुंजी के हिसाब से लेक्सिकोग्राफ़िक रूप से.
  3. तय की गई चाइल्ड कुंजी के लिए true वैल्यू वाले बच्चे इसके बाद आते हैं. अगर आपने कई बच्चों की वैल्यू true है, उन्हें लेक्सिकोग्राफ़िक तौर पर इस क्रम में लगाया गया है: बटन दबाएं.
  4. अंकों वाली वैल्यू वाले बच्चे आगे बढ़ते हैं. इन्हें बढ़ते क्रम में लगाया जाता है. अगर एक से ज़्यादा बच्चे हैं, तो बताए गए चाइल्ड नोड के लिए समान संख्यात्मक मान होते हैं, उन्हें कुंजी के अनुसार क्रम में लगाया जाता है.
  5. स्ट्रिंग, नंबर के बाद आती हैं और उन्हें अंग्रेज़ी के वर्णमाला के क्रम में, बढ़ते क्रम में लगाया जाता है. अगर कई बच्चों के पास दिए गए चाइल्ड नोड के लिए एक ही वैल्यू है, तो उन्हें कीवर्ड के हिसाब से, लिक्सिकोग्राफ़ी के क्रम में लगाया जाता है.
  6. ऑब्जेक्ट आखिरी में आते हैं और उन्हें बढ़ते क्रम में कुंजी के हिसाब से लेक्सिकोग्राफ़िक रूप से लगाया जाता है.
फ़िल्टर किए गए नतीजे बिना क्रम के दिखते हैं. अगर आपके डेटा का क्रम ज़रूरी है, तो आपको Firebase से वापस आने के बाद अपने ऐप्लिकेशन में नतीजों को क्रम से लगाना चाहिए.

orderBy="$key"

अपने डेटा को क्रम से लगाने के लिए orderBy="$key" पैरामीटर का इस्तेमाल करने पर, डेटा को कुंजी के हिसाब से, बढ़ते क्रम में दिखाया जाएगा. ध्यान रखें कि कुंजियां सिर्फ़ स्ट्रिंग हो सकती हैं.

  1. जिन बच्चों के पास कुंजी होती है उन्हें 32-बिट वाले पूर्णांक के तौर पर पार्स किया जा सकता है, वे पहले आते हैं. इन्हें बढ़ते क्रम में लगाया जाता है ऑर्डर.
  2. जिन बच्चों में स्ट्रिंग वैल्यू आगे आती है उन्हें बढ़ते क्रम में अलग-अलग शब्दों में समझा जाता है ऑर्डर.

OrderBy="$value"

डेटा को क्रम से लगाने के लिए orderBy="$value" पैरामीटर का इस्तेमाल करने पर, बच्चे उन्हें उनकी वैल्यू के हिसाब से क्रम में लगाया जाता है. डेटा को और चाइल्ड कुंजी के हिसाब से क्रम में लगाने की शर्तें, एक ही होती हैं. हालांकि, सिर्फ़ किसी खास चाइल्ड कुंजी की वैल्यू के बजाय नोड की वैल्यू का इस्तेमाल किया जा सकता है.

OrderBy="$प्राथमिकता"

अपने डेटा को क्रम से लगाने के लिए orderBy="$priority" पैरामीटर का इस्तेमाल करने पर, बच्चों का क्रम, उनकी प्राथमिकता और कुंजी के हिसाब से तय किया जाता है. ध्यान रखें कि प्राथमिकता मान में सिर्फ़ अंक या स्ट्रिंग हो सकती हैं.

  1. जिन बच्चों के लिए कोई प्राथमिकता नहीं तय की गई है (डिफ़ॉल्ट) वे पहले दिखते हैं.
  2. नंबर वाले बच्चों के क्रम में बच्चों का नंबर आता है. उन्हें प्राथमिकता के हिसाब से, अंकों के हिसाब से क्रम में लगाया जाता है. छोटा से बड़ा.
  3. स्ट्रिंग वाले बच्चे सबसे आखिर में आते हैं. इन्हें प्राथमिकता के हिसाब से, अंग्रेज़ी के अक्षरों के क्रम में लगाया जाता है.
  4. जब भी दो बच्चों की प्राथमिकता एक जैसी होती है (इसमें कोई प्राथमिकता नहीं होती), तो उन्हें 'की' के हिसाब से क्रम में लगाया जाता है. अंकों वाली कुंजियां पहले आती हैं (संख्या के हिसाब से क्रम में लगाई गई हैं). इसके बाद, बाकी कुंजियां (क्रम से लगाई गई) आती हैं लेक्सिकोग्राफ़िक रूप से).

प्राथमिकताओं के बारे में ज़्यादा जानकारी के लिए, एपीआई रेफ़रंस देखें.

REST API से स्ट्रीमिंग

Firebase REST एंडपॉइंट, EventSource / सर्वर से भेजे गए इवेंट प्रोटोकॉल की मदद से, हमारी सेवाओं में एक ही जगह पर होने वाले बदलावों को आसानी से स्ट्रीम किया जा सकता है Firebase डेटाबेस.

स्ट्रीमिंग शुरू करने के लिए, हमें ये काम करने होंगे:

  1. क्लाइंट के स्वीकार करें हेडर को text/event-stream पर सेट करें
  2. एचटीटीपी रीडायरेक्ट का पालन करें. खास तौर पर, एचटीटीपी स्टेटस कोड 307 का पालन करें
  3. अगर Firebase डेटाबेस की जगह को पढ़ने के लिए अनुमति की ज़रूरत है, तो auth क्वेरी पैरामीटर शामिल करें

इसके बदले, सर्वर नाम वाले इवेंट भेजेगा, क्योंकि अनुरोध किए गए यूआरएल पर डेटा की स्थिति में बदलाव होता है. इन मैसेज की बनावट EventSource प्रोटोकॉल के मुताबिक है:

event: event name
data: JSON encoded data payload

सर्वर नीचे दिए गए इवेंट भेज सकता है:

रखें JSON कोड में बदला गया डेटा, दो कुंजियों वाला एक ऑब्जेक्ट होगा: पाथ और डेटा
पाथ, अनुरोध किए गए यूआरएल से मिलती-जुलती जगह दिखाता है
क्लाइंट को उस जगह के कैश मेमोरी में मौजूद सभी डेटा को मैसेज में दिए गए डेटा से बदलना होगा
पैच JSON कोड में बदला गया डेटा, दो कुंजियों वाला एक ऑब्जेक्ट होगा: पाथ और डेटा
पाथ, अनुरोध किए गए यूआरएल से मिलती-जुलती जगह दिखाता है
डेटा में मौजूद हर कुंजी के लिए, क्लाइंट को कैश मेमोरी से जुड़ी कुंजी को मैसेज में मौजूद कुंजी के डेटा से बदलना चाहिए
कीप-अलाइव इस इवेंट के लिए डेटा शून्य है, किसी कार्रवाई की ज़रूरत नहीं है
रद्द करें इस इवेंट का डेटा शून्य है
यह इवेंट तब भेजा जाएगा, जब Firebase Realtime Database Security Rules की वजह से अनुरोध की गई जगह पर डेटा पढ़ने की अनुमति नहीं होगी
auth_Revoked इस इवेंट का डेटा, एक स्ट्रिंग है. इससे पता चलता है कि क्रेडेंशियल की समयसीमा खत्म हो गई है
यह इवेंट तब भेजा जाएगा, जब दिया गया ऑथराइज़ेशन पैरामीटर मान्य नहीं होगा

नीचे इवेंट के एक सेट का उदाहरण दिया गया है, जिसे सर्वर भेज सकता है:

// Set your entire cache to {"a": 1, "b": 2}
event: put
data: {"path": "/", "data": {"a": 1, "b": 2}}


// Put the new data in your cache under the key 'c', so that the complete cache now looks like:
// {"a": 1, "b": 2, "c": {"foo": true, "bar": false}}
event: put
data: {"path": "/c", "data": {"foo": true, "bar": false}}


// For each key in the data, update (or add) the corresponding key in your cache at path /c,
// for a final cache of: {"a": 1, "b": 2, "c": {"foo": 3, "bar": false, "baz": 4}}
event: patch
data: {"path": "/c", "data": {"foo": 3, "baz": 4}}

अगर Go का इस्तेमाल किया जा रहा है, तो Firego देखें. यह Firebase REST और स्ट्रीमिंग एपीआई के लिए, तीसरे पक्ष का रैपर है.