InterSystems प्लेटफार्मों के लिए GraphQL

GraphQL डेटा प्राप्त करने के लिए डेटा संरचनाओं और विधियों की घोषणा करने के लिए एक मानक है, जो क्लाइंट और सर्वर के बीच एक अतिरिक्त परत के रूप में कार्य करता है। यदि यह ग्राफक्यूएल के बारे में आपकी पहली बार सुनवाई है, तो यहां कुछ अच्छे संसाधन हैं: एक और दो ।

इस लेख में मैं आपको बताऊंगा कि आप इंटरसिस्टम तकनीकों का उपयोग करके अपनी परियोजनाओं में ग्राफकलाइन का उपयोग कैसे कर सकते हैं।

वर्तमान में, InterSystems प्लेटफार्मों पर क्लाइंट-सर्वर एप्लिकेशन बनाने के कई तरीके हैं:

• बाकी
• वेब सॉकेट
• सोप

लेकिन GraphQL इतना अच्छा क्यों है? उदाहरण के लिए, REST के साथ यह कौन सी नई सुविधाएँ देगा?

ग्राफकॉल में कई प्रकार के प्रश्न हैं:

• डेटा प्राप्त करने के लिए सर्वर से क्वेरी का अनुरोध किया जाता है, ठीक उसी प्रकार जैसे कि डेटा प्राप्त करने के लिए GET अनुरोधों का उपयोग करने की सिफारिश की जाती है।
• उत्परिवर्तन - यह प्रकार सर्वर पर डेटा बदलने के लिए जिम्मेदार है। REST में, डेटा POST (PUT, DELETE) अनुरोधों को बदलने के लिए।
  म्यूटेशन , क्वेरी की तरह , डेटा वापस कर सकते हैं - यह सुविधाजनक है यदि आप म्यूटेशन के तुरंत बाद सर्वर से अद्यतन जानकारी का अनुरोध करना चाहते हैं।
• सदस्यताएँ क्वेरी का एक ही प्रकार है जो डेटा आउटपुट करेगा। अंतर केवल इतना है कि क्लाइंट पर पेज रेंडर करने से क्वेरी ट्रिगर होती है, और म्यूटेशन द्वारा सब्सक्रिप्शन को ट्रिगर किया जाता है ।

GraphQL की मुख्य विशेषताएं और इसके लिए उपयोग करने लायक क्या है

ग्राहक तय करता है कि वह क्या प्राप्त करना चाहता है।

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

यह एक सरल ग्राफक्यूएल क्वेरी की तरह दिखता है:

{ Sample_Company { Name } } 

JSON प्रारूप में उत्तर:

 { "data": { "Sample_Company": [ { "Name": "CompuSoft Associates" }, { "Name": "SynerTel Associates" }, { "Name": "RoboGlomerate Media Inc." }, { "Name": "QuantaTron Partners" } ] } } 

एकल प्रविष्टि बिंदु

ग्राफक्यूएल में, डेटा के साथ काम करने के लिए, हम हमेशा प्रविष्टि ( एंडपॉइंट ) के एक बिंदु पर जाते हैं - जीक्यूएल सर्वर। संरचना, फ़ील्ड, क्वेरी पैरामीटर को बदलते हुए, हम विभिन्न डेटा के साथ काम करते हैं। एक ही REST में कई समापन बिंदु हैं।

सरल उदाहरण के साथ ग्राफकैल के साथ REST की तुलना करें:

मान लें कि आप उपयोगकर्ता सामग्री अपलोड करना चाहते हैं, REST के लिए आपको सर्वर से तीन अनुरोध करने होंगे:

1. हम उपयोगकर्ता डेटा को उसकी आईडी द्वारा लोड करते हैं
2. आईडी द्वारा हम उसके पद प्राप्त करते हैं
3. आईडी से हम इसके सब्सक्राइबर प्राप्त करते हैं

इन अनुरोधों के मिलान कार्ड:

  <Route Url="/user/:id" Method="GET" Call="GetUserByID"/> <Route Url="/user/:id/posts" Method="GET" Call="GetUserPostsByID"/> <Route Url="/user/:id/follovers" Method="GET" Call="GetUserFolloversByID"/> 

एक नया डेटासेट प्राप्त करने के लिए, REST कार्ड को नए समापन बिंदुओं के साथ पूरक करना होगा।

ग्राफक्लाइन इस कार्य को एक ही प्रश्न में करता है। ऐसा करने के लिए, अनुरोध निकाय में निम्नलिखित निर्दिष्ट करें:

 { operationName: null, // query    ( query TestName(...){...} ) query: "query { User(id: "ertg439frjw") { name posts { title } followers(last: 3) { name } } }", variables: null //  ,    query* } 

इस क्वेरी से मिलान कार्ड:

  <Route Url="/graphql" Method="POST" Call="GraphQL"/> 

इसके अलावा, यह सर्वर पर केवल समापन बिंदु है।

GraphQL और GraphiQL स्थापित करें

GraphQL का उपयोग शुरू करने के लिए, आपको कुछ कदम करने की आवश्यकता है:

1. GitHub से नवीनतम रिलीज़ डाउनलोड करें और इच्छित क्षेत्र में आयात करें
2. सिस्टम प्रबंधन पोर्टल पर जाएं और InterSystems Data Platform (Caché, Ensemble or IRIS) से अपने उत्पाद के लिए एक नया वेब एप्लिकेशन बनाएं:
   
   • नाम - /
   • स्कोप - जैसे नमूने
   • हैंडलर क्लास - ग्राफलाइन.रेस्ट.मेन
3. ग्राफिक्वेल, ग्राफकॉल प्रश्नों का परीक्षण करने के लिए एक खोल है। नवीनतम इकट्ठे ग्राफिसेल रिलीज को डाउनलोड करें या इसे स्वयं बनाएं
4. एक नया वेब एप्लिकेशन बनाएं:
   
   • नाम - / ग्रेफिक
   • स्कोप - जैसे नमूने
   • CSP फ़ाइलों का भौतिक पथ C: \ InterSystems \ GraphiQL / है

चलिए परिणाम को देखते हैं

इस लिंक पर ब्राउज़र पर जाएँ http: // localhost: 57772 / graphiql / index.html (लोकलहोस्ट - सर्वर, 57772 - पोर्ट)

मुझे लगता है कि अनुरोध और प्रतिक्रिया क्षेत्र के साथ सब कुछ स्पष्ट है, और स्कीमा प्रलेखन है जो क्षेत्र में सभी संग्रहीत वर्गों के लिए उत्पन्न होता है।

सर्किट में शामिल हैं:

• कक्षाएं
• गुण, तर्क और उनके प्रकार
• उपरोक्त सभी का विवरण, जो टिप्पणियों से उत्पन्न होता है

उदाहरण के रूप में नमूना_कंपनी वर्ग का उपयोग करने वाले आरेख पर विचार करें:

ग्राफिक्वेल ऑटोकंप्लीशन का भी समर्थन करता है, जिसे Ctrl + Space कुंजी संयोजन के साथ कहा जा सकता है:

अनुरोध

प्रश्न या तो सरल या नेस्टेड हो सकते हैं; आप कई डेटासेट क्वेरी कर सकते हैं। नीचे दो अलग-अलग वर्गों से डेटा क्वेरी करने का एक उदाहरण है नमूना_पर्सन और नमूना_कंपनी :

छानने

फिलहाल, केवल सख्त समानता का समर्थन किया जाता है:

पृष्ठ पर अंक लगाना

पेजिनेशन के 4 कार्य कार्यान्वित किए जाते हैं, यदि आवश्यक हो तो उन्हें संयोजित किया जा सकता है:

• बाद: n - n से अधिक आईडी वाले सभी रिकॉर्ड
• पहले: n - n से कम आईडी वाले सभी रिकॉर्ड
• पहला: n - पहला n प्रविष्टियां
• अंतिम: एन - अंतिम एन प्रविष्टियां

क्षेत्र

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

• सभी वर्गों के दायरे में
• सुपरक्लास से प्राप्त हुई कक्षाएं
• विशिष्ट पैकेज से संबंधित कक्षाएं ( ग्राफक्यूएल.सोप.पैकेज )

दृश्यता सीमित होने के तरीके को बदलने के लिए, आपको स्टूडियो खोलने, वांछित क्षेत्र पर जाने और ग्राफ़कॉल.सेटिंग क्लास खोलने की आवश्यकता है । इसमें SCOPECLASS पैरामीटर है, इसका डिफ़ॉल्ट मान GraphQL.Scope.All पर सेट है - यह एक वर्ग है जो क्षेत्र में कक्षाओं की दृश्यता को सीमित करने के लिए इंटरफ़ेस का वर्णन करता है:

कक्षा की दृश्यता की सीमा को बदलने के लिए, आपको बस ऊपर बताए गए मानों में से एक को सेट करने की आवश्यकता है, GraphQL.Scope.Package या GraphQL.Scope.Superclass ।

GraphQL.Scope.Package के मामले में, इस वर्ग में जाना और पैकेज पैरामीटर का मान वांछित पैकेज के नाम पर सेट करना आवश्यक है, उदाहरण के लिए, नमूना , तो इस पैकेज से सभी संग्रहीत कक्षाएं उपलब्ध होंगी:

और GraphQL.Scope.Superclass के साथ , आप बस उन वर्गों में इस वर्ग से विरासत में प्राप्त कर सकते हैं जिनकी आपको आवश्यकता है:

वर्तमान में समर्थित है

संबंधित खोज:

• बुनियादी
• नेस्टेड ऑब्जेक्ट्स
  
  • केवल एक दृष्टिकोण के लिए कई
• सरल प्रकार की शीट
• वस्तुओं की चादर

कार्यान्वयन में है

संबंधित खोज:

• नेस्टेड ऑब्जेक्ट्स
  
  • सभी प्रकार के संबंधों के लिए समर्थन
• छानने
  
  • असमानता का समर्थन

योजनाओं में

• Mutaions
• उपनाम
• निर्देशों
• टुकड़े

→ प्रोजेक्ट रिपॉजिटरी से लिंक
→ डेमो सर्वर से लिंक

मुद्दों के अनुरोधों का बहुत स्वागत है।
हमारी परियोजना के विकास का पालन करें!