"ग्राफक्लाइन: आधुनिक वेब अनुप्रयोगों के लिए क्वेरी भाषा" पुस्तक

हाय, हब्रोज़ितेली! हमने ग्राफक्यूएल क्वेरी भाषा पर एक पुस्तक प्रकाशित की है। हमने अध्याय "एनाटॉमी ऑफ़ ग्राफकॉक क्वेरीज़" के अनुवाद को साझा करने का फैसला किया

स्नोमोटो एक काल्पनिक स्की स्थल है। इस अध्याय में उदाहरणों के लिए, हम दिखावा करेंगे कि यह एक वास्तविक पर्वत है और हम वहां काम करते हैं। हम देखेंगे कि स्नो फैंग वेब टीम वास्तविक समय की जानकारी प्रदान करने के लिए ग्राफकॉक का उपयोग कैसे करती है: स्की लिफ्टों और स्की रन की स्थिति के बारे में जानकारी। स्नो फैंग स्की पेट्रोल अपने स्मार्टफोन से सीधे स्की लिफ्टों और ढलानों को खोल और बंद कर सकता है। इस अध्याय में उदाहरणों का पालन करने के लिए, ग्राफकॉइन प्लेग्राउंड प्लेटफ़ॉर्म (स्नोथॉथ पूनीहवे) पर स्नो फैंग इंटरफ़ेस देखें।


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

query { allLifts { name status } } 

हैंडलिंग में त्रुटि
सफल अनुरोध डेटा कुंजी वाले JSON दस्तावेज़ लौटाते हैं। असफल अनुरोध त्रुटि कुंजी वाले JSON दस्तावेज़ लौटाते हैं। जो गलत हुआ, उसका विवरण इस कुंजी के तहत JSON डेटा के रूप में प्रेषित किया जाता है। JSON प्रतिक्रिया में "डेटा" और "त्रुटि" दोनों हो सकते हैं।

आप एक क्वेरी दस्तावेज़ में कई क्वेरी जोड़ सकते हैं, लेकिन एक बार में केवल एक ही ऑपरेशन शुरू किया जा सकता है। उदाहरण के लिए, आप एक क्वेरी दस्तावेज़ में दो क्वेरी ऑपरेशन रख सकते हैं:

 query lifts { allLifts { name status } } query trails { allTrails { name difficulty } } 

जब आप प्ले बटन पर क्लिक करते हैं, तो ग्राफकॉइन प्लेग्राउंड आपको इन दो ऑपरेशनों में से एक का चयन करने के लिए संकेत देता है।

यदि आप सभी निर्दिष्ट डेटा के लिए एक अनुरोध भेजना चाहते हैं, तो आपको एक ही अनुरोध में सब कुछ डालने की आवश्यकता है:

 query liftsAndTrails { liftCount(status: OPEN) allLifts { name status } allTrails { name difficulty } } 

यहाँ ग्राफ़िकल के लाभ दिए गए हैं। हम एक अनुरोध में विभिन्न प्रकार के डेटा प्राप्त कर सकते हैं। हम स्थिति से एक लिफ्टकाउंट का अनुरोध करते हैं, जो हमें वर्तमान में इस स्थिति के लिफ़्ट की संख्या का पता लगाने की अनुमति देता है। हम प्रत्येक लिफ्ट के नाम और स्थिति का भी अनुरोध करते हैं। अंत में, हम प्रत्येक ट्रेस का नाम और स्थिति का अनुरोध करते हैं।

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

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

जब हम प्रश्न लिखते हैं, तो हम उन क्षेत्रों का चयन करते हैं जिनकी हमें आवश्यकता होती है, उन्हें घुंघराले ब्रेसिज़ में संलग्न करना। इन ब्लॉकों को नमूने कहा जाता है। वे क्षेत्र जिन्हें हम चयन में परिभाषित करते हैं, वे सीधे ग्राफ़िकल प्रकार से संबंधित हैं। फ़ील्ड लिफ्ट, ऑल लिफ्ट, और ऑलट्रैल्स को क्वेरी प्रकार में परिभाषित किया गया है।

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

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

 query liftsAndTrails { open: liftCount(status: OPEN) chairlifts: allLifts { liftName: name status } skiSlopes: allTrails { name difficulty } } 

निम्नलिखित उत्तर है:

 { "data": { "open": 5, "chairlifts": [ { "liftName": "Astra Express", "status": "open" } ], "skiSlopes": [ { "name": "Ditch of Doom", "difficulty": "intermediate" } ] } } 

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

 query closedLifts { allLifts(status: "CLOSED" sortBy: "name") { name status } } 

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

 query jazzCatStatus { Lift(id: "jazz-cat") { name status night elevationGain } } 

यहाँ हम देखते हैं कि उत्तर में जैज़ कैट केबल कार के लिए नाम, स्थिति, रात और ऊंचाई शामिल है।

»पुस्तक की अधिक जानकारी प्रकाशक की वेबसाइट पर पाई जा सकती है
» सामग्री
» अंश

फेरीवालों के लिए कूपन पर 25% की छूट

पुस्तक के पेपर संस्करण के भुगतान पर, पुस्तक का एक इलेक्ट्रॉनिक संस्करण ई-मेल द्वारा भेजा जाता है।