👽 📑 👩🏻‍🔬 WCF RIA सेवाएँ। डेटा प्राप्त करें। भाग २ 🧗🏼 👨🏻‍⚕️ 🏴󠁧󠁢󠁷󠁬󠁳󠁿

WCF RIA सेवाएँ। प्रारंभ। भाग 1
WCF RIA सेवाएँ। डेटा प्राप्त करें। भाग २
WCF RIA सेवाएँ। डेटा अपडेट। भाग ३
WCF RIA सेवाएँ। पेश है मॉडल-व्यू-व्यूमॉडल (एमवीवीएम) पैटर्न। भाग ४

सामान्य जानकारी

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

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

चरण 1: डोमेन सेवा के लिए एक पैरामीटर अनुरोध जोड़ना

हमने पिछले पाठ में डोमेन सेवा बनाने के बाद ऐसा देखा था:

public IQueryable<Task> GetTasks() { return this.ObjectContext.Tasks; }

यह विधि कार्य तालिका से सभी प्रविष्टियों को IQueryable के प्रगणित प्रकार के रूप में लौटाती है और तर्कों को स्वीकार नहीं करती है। यदि क्लाइंट पक्ष पर अधिक विशिष्ट अनुरोध प्राप्त करने की आवश्यकता है, तो आपको डोमेन सेवा में एक विधि जोड़ने की आवश्यकता है, जो बदले में ग्राहक को स्वचालित रूप से उपलब्ध होगी। IEnumerable प्रकार का डेटा वापस करना भी संभव है, लेकिन यदि मुख्य डेटा प्रदाता (Entity Framework या LINQ to SQL) IQueryable लौटाता है, तो इसे अलग से लागू करने की आवश्यकता होगी।

अब हम अपने एप्लिकेशन को इस तरह से आधुनिकीकरण कर रहे हैं जैसे कि किसी निश्चित तिथि सीमा में घटनाओं को प्राप्त करने की क्षमता को जोड़ना। ऐसा करने के लिए, निम्न कोड को डोमेन सेवा में जोड़ें:

 public IQueryable<Task> GetTasksByStartDate( DateTime lowerDateTimeInclusive, DateTime upperDateTimeInclusive) { return this.ObjectContext.Tasks.Where( t => t.StartDate >= lowerDateTimeInclusive && t.StartDate <= upperDateTimeInclusive); }

चरण 2: तत्काल डेटा प्राप्त करने के लिए UI बदलें।

ऐसा करने के लिए, हमारे पृष्ठ में कुछ तत्व जोड़ें। मेनपेज खोलें। xaml। ग्रिड को स्थानांतरित करें ताकि तत्वों को जोड़ने के लिए इसके ऊपर खाली स्थान हो। "ड्रैग एंड ड्रॉप" का उपयोग करके टूलबार से दो टेक्स्टबॉक्स और एक बटन जोड़ें। क्रमशः बनाए गए तत्वों को नाम दें: लोअरडेट, अपरडेट, सर्चबटन।

सामग्री बटन को "तिथि तक खोजें" में बदलें।

चरण 3: DomainContext का उपयोग करके क्लाइंट पर अनुरोध के परिणाम को प्राप्त करना

जैसा कि आप याद करते हैं, DomainContext एक ऑटो-जनरेटेड कोड है जो एप्लिकेशन के सर्वर साइड की क्षमताओं का प्रतिनिधित्व करता है। यही है, यदि डोमेन सेवा को टास्कडोमैन सर्विस कहा जाता है, तो एप्लिकेशन के क्लाइंट भाग को टास्कडोमेनकॉन्टेक्स कहा जाता है। यह एसिंक्रोनस मोड में सर्वर भाग तक पहुंचने की क्षमता प्रदान करता है, साथ ही क्लाइंट पक्ष पर किए गए परिवर्तनों को भी सहेज सकता है।

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

नए बनाए गए बटन पर "क्लिक करें" घटना जोड़ें। और इस ईवेंट के हैंडलर में, निम्न कोड जोड़ें:

 private void searchButton_Click(object sender, RoutedEventArgs e) { DateTime lowerDateVal; DateTime upperDateVal; GetDates(out lowerDateVal, out upperDateVal); TasksDomainContext context = new TasksDomainContext(); taskDataGrid.ItemsSource = context.Tasks; EntityQuery<Task> query = context.GetTasksByStartDateQuery(lowerDateVal, upperDateVal); LoadOperation<Task> loadOp = context.Load(query); }

कोड की अंतिम 4 पंक्तियों पर ध्यान दें, क्योंकि पहले 3 को संबंधित क्षेत्रों से केवल दर्ज की गई तारीख मिल रही है, और इस तरह दिखता है:

  private void GetDates(out DateTime lowerDateVal, out DateTime upperDateVal) { lowerDateVal = DateTime.MinValue; upperDateVal = DateTime.MaxValue; if (!string.IsNullOrWhiteSpace(lowerDate.Text)) { lowerDateVal = DateTime.Parse(lowerDate.Text); } if (!string.IsNullOrWhiteSpace(upperDate.Text)) { upperDateVal = DateTime.Parse(upperDate.Text); } }

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

एक डोमेन संदर्भ संस्थाओं के संग्रह प्रदान करता है, जिसमें प्रसंस्करण अनुरोधों के बाद सेवा डोमेन द्वारा लौटाए गए संग्रह शामिल हैं। इस स्तर पर, सेवा डोमेन टास्क टेबल से केवल डेटा का संग्रह प्रदान करता है।

कृपया ध्यान दें कि डेटा के लिए कोई भी अनुरोध करने से पहले यह कोड DataGrid में ItemSource को कार्य संग्रह के साथ बदल देता है। यह इस तथ्य के कारण आवश्यक है कि डोमेन संदर्भ द्वारा भेजे गए अनुरोध अतुल्यकालिक हैं और सर्वर से प्रतिक्रिया आने के बाद ही संग्रह की सामग्री को प्रतिस्थापित करेंगे। यह संग्रह INotifyCollectionChanged इंटरफ़ेस को लागू करता है और इसकी सामग्री को अद्यतन करने के लिए DataGrid (या किसी भी संबद्ध तत्व) को निर्देशित घटनाओं को बढ़ाने में सक्षम है।

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

सिद्धांत रूप में, यह वही चीज़ है जो पहले पाठ से DomainDataSource के अंतर्गत आती है।

चरण 4: एक एकल वस्तु को लौटाने की विधि जोड़ना

ताकि विधि संग्रह को वापस न करे, इसे आवश्यक घोषित करें। संकलन के बाद, यह ग्राहक की ओर से भी उपलब्ध होगा:

 public Task GetTask(int taskId) { return this.ObjectContext.Tasks.FirstOrDefault(t => t.TaskId == taskId); }

सेटिंग्स कन्वेंशन

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

और विशेषताओं का उपयोग करके अनुकूलन विकल्पों के बारे में मत भूलना। उदाहरण के लिए, क्वेरी पक्ष के लिए, आप [क्वेरी] विशेषता के साथ तरीकों को सजा सकते हैं, जिससे आपका कोड अधिक पठनीय और समझने में आसान हो जाएगा। यह याद रखना चाहिए कि वापसी का प्रकार भी विधि के उद्देश्य के बारे में बहुत कुछ कहता है। उदाहरण के लिए, एक तरीका जो IQueryable, IEnumberable को लौटाता है - डेटा प्राप्त करने के लिए विशिष्ट रूप से जिम्मेदार है। हालांकि, क्वेरी विशेषता का उपयोग करने का लाभ यह है कि यह कुछ अतिरिक्त मापदंडों का समर्थन करता है, जैसे कि लौटाए गए परिणामों की अधिकतम संख्या, जो अनुरोध के बाद डेटाबेस से आवश्यक से अधिक वापस होने पर भी, उनकी संख्या को सीमित कर देगा।

कस्टम डोमेन सेवाएँ

लेकिन क्या होगा यदि आप एंटिटी फ्रेमवर्क का उपयोग नहीं करना चाहते हैं? वैकल्पिक रूप से, आप LINQ to SQL का उपयोग कर सकते हैं। मैं नई परियोजनाओं के साथ इकाई ढांचे का उपयोग करने की सलाह दूंगा। और यदि संभव हो तो पुराने के साथ।

LINQ to SQL टूलकिट के माध्यम से WCF RIA सर्विसेज में समर्थित है।

हालाँकि, कई अन्य डेटा एक्सेस रणनीतियों का उपयोग करते हैं, जैसे nHibernate और अन्य डेटा स्रोत जैसे कि Oracle, MySQL और कई अन्य। यह सब डब्ल्यूसीएफ आरआईए सेवाओं में भी इस्तेमाल किया जा सकता है, लेकिन आपको डेटा ऑब्जेक्ट्स को सरल संस्थाओं के रूप में परिभाषित करने और कोड में आगे उपयोग करने की आवश्यकता है जैसा कि आप फिट देखते हैं। इस दृष्टिकोण को POCO (Plain Old CLR Objects) डोमेन सेवा कहा जाता है।

ऐसी डोमेन सेवा बनाने के लिए, सेवा डोमेन वर्ग को सीधे DomainService से विरासत में प्राप्त होना चाहिए, न कि LinqToEntitiesDomainService से। निर्माण विज़ार्ड में, सेवा डोमेन के लिए कोड बनाएं, "उपलब्ध संदर्भ वर्ग" ड्रॉप-डाउन मेनू में "खाली डोमेन सेवा वर्ग" चुनें। तब आप संस्थाओं को परिभाषित करते हैं, यदि आपके डेटा स्रोत IQueryable का समर्थन नहीं करते हैं और डेटा स्रोत के आधार पर विधियों में आपको जो कुछ भी करना है, इन संस्थाओं के IEnumerable संग्रह लौटाएं।

इसके बाद, आपको अपनी सेवा को स्रोत डेटा और आपके द्वारा काम की जाने वाली वस्तुओं के अनुसार डिजाइन करना होगा। इन ऑब्जेक्ट्स में अन्य ऑब्जेक्ट्स या सेट-इन .NET समर्थित प्रकारों के गुण होने चाहिए।

जिस कुंजी के साथ आप अपनी संस्थाओं को फ्रेम करते हैं, वह निर्धारित करती है कि उनके पास महत्वपूर्ण गुण होने चाहिए जो विशिष्ट रूप से उनकी पहचान करते हैं। आमतौर पर "इंट" या "गाइड"। इस गुण को [Key] विशेषता के रूप में निर्दिष्ट करें।

नीचे वह कोड है जो दिखाता है कि किसी सेवा और उसकी इकाई का POCO डोमेन कैसे घोषित किया जाए:

 public class Foo { [Key] public int FooId { get; set; } public string Name { get; set; } } [EnableClientAccess()] public class MyPOCODomainService : DomainService { public IEnumerable<Foo> GetFoos() { return new List<Foo> { new Foo { FooId = 42, Name = "Fred" } }; } }

[कुंजी] विशेषता के अलावा, यदि आपके पास ऐसे गुण हैं जो स्वयं प्रकार की संस्थाएं (संबंधित निकाय या संगठन) हैं, तो आपको इस इकाई में गुण जोड़ने की आवश्यकता है, उदाहरण के लिए, एक आईडी जो प्रमुख क्षेत्रों के पत्राचार को सेट करती है। इसके अलावा, [एसोसिएशन] विशेषता को सीधे इकाई संपत्ति पर निर्दिष्ट किया जाना चाहिए, जो संपत्ति आईडी दिखाता है, जो संबंधों (संबंधों) को स्थापित करता है और रिपोर्ट करता है कि यह विदेशी कुंजी है। आपको इकाई की संपत्ति पर [शामिल करें] विशेषता को भी निर्दिष्ट करना होगा, ताकि बाल इकाई को हमेशा आरआईए सेवाओं का उपयोग करके पुनर्प्राप्त किया जाए।

प्रोजेक्ट शुरू करने के बाद, एक विंडो प्राप्त करें जहाँ आप तिथि के अनुसार चयन कर सकते हैं:

इस ट्यूटोरियल के लिए वीडियो

स्रोत कोड

गीथूब पर

WCF RIA सेवाएँ। डेटा प्राप्त करें। भाग २